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CHAPTER ONE 
INTRODUCTION 

1.1 INTRODUCTION 

RSX-15 is a real-time monitor system designed for handling real-time 
information in a multiprogreumning environment. The modular construc- 
tion of the system allows the user to configure his availcOale hardware 
and software resources to best fit his requirements. 

RSX-15 controls and supervises all operations within the system in- 
cluding any number of core- and disk-resident programs (called Tasks) 
limited in number only by available space. This control and super- 
vision allows an unlimited number of Tasks to share core and disk 
memory, input/output device h2uidlers, and other resources of the system. 

The execution of Tasks is determined by software priorities, hardware 
interrupts, timing algorithms, and requests from other Tasks. The 
user can install a new Task on-line, establish its software priority 
from any of 512 distinct levels, and then request its activation at 
any time with an automatic reactivation at any periodic interval of 
time thereafter. 

Utilizing simple time-directed commands, the user can dynamically 
schedule Tasks from the console terminal or from within a Task. 
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Device independence in RSX then allows the user to obtain results of 
that Task immediately on his Teletype? or store them on a mass storage 
device such as a disk or magnetic tape for future reference. 

I/O requests from Tasks are queued and processed by RSX on a priority 
basis allowing high priority requests access to heavily used devices 
which have pending lower priority requests. Delays are further re- 
duced by having the actual transfer of data being performed by the 
I/O Processor independent of the Central Processing Unit, thus allow- 
ing concurrent Task execution and I/O processing. 



1.2 HARDWARE REQUIREMENTS AND OPTIONS 

The minimum hardware configuration required to operate the RSX-15 

system on a PDP-15/35**is as follows: 

16 K of core memory 

API - Automatic Priority Interrupt 

EAE - Extended Arithmetic Element 

Real Time Clock (frequency is 16.7 msec for 60 Hz systems and 20 

msec for 50 Hz systems.) 

NOTE: The clock must be wired to API hardware level 3. 
One (1) RS15 DECdisk (262,000 word fixed head) and oned) RF15 

controller. 
One (1) TU56 DECtape unit and controller. 
One (1) KSR35 Teletype 
High Speed Paper Tape Reader 
High Speed Paper Tape Punch 

The RSX-15 system supports the following additional hardware: 

Addition of core memory in increments of 4K up to 32K. 

Addition of one or more disk units. The disk controller is de- 
signed to acconffliodate up to 8 disk units (2 million words). 

Addition of one or more DECtape units. The controller is designed 
to accommodate up to 4 TU56 DECtape units (8 tape drives). 

Addition of one or more Teletypes. Up to 16 additional Teletypes, 
either model KSR33 or KSR35, may be added to the standard 
system (under LT15/LT19) . 

One (1) VTOl storage tube display system. (Tektronix model 611 
storage tube with interface) . 

One (1) to Eight (8) TUlO - 7 or 9 track IBM compatible magtape 
transport (7 and 9 track may not be mixed) 

One (1) LP15 - Line Printer. 



* 
** 



Teletype is a trademark of the Teletype Corporation 
A fully ECOed PDP-15 is required. 
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1.3 SYSTEM SOFTWARE 

RSX-15 is a complete system for program preparation, compilation, 
assembly, debugging, and operation in a system that has been config- 
ured to the user's needs. 

The RSX-15 system utilizes two separate monitors, the ADVANCED Soft- 
ware Monitor and the Real-Time Monitor. The ADVANCED Software Moni- 
tor is the standard monitor for the PDP-15/20 and PDP-15/35 computers. 

The ADVANCED Monitor is used in the development, debugging, and build- 
ing of executable Tasks for the Real-Time Monitor. The system soft- 
ware includes the FORTRAN Iv compiler, MACRO assembler, TEXT EDITOR, 
TASK BUILDER, and numerous Utility programs*. 

The TASK BUILDER, TKB, is used to build user's Tasks from relocatable 
binary files by linking them together along with library functions to 
constitute an executable Task that runs under control of the Real- 
Time Monitor. TKB is quite similar to the CHAIN program allowing 
very elaborate overlay structures to be built. A resultant Task is 
defined by a name (Task name) , default run priority, core partition 
and common block requirements, and resident code. The Task, which 
resides either on paper tape or DECtape, is now ready to be incorpo- 
rated into the real-time operating system under control of the Real- 
Time Monitor. Chapter five discusses the TASK BUILDER in greater 
detail. 

The Real-Time Monitor is used to supervise and control the execution 
of real-time Tasks. The real-time software includes the RSX-15 
EXECUTIVE, I/O Device Handler Tasks, Resident MCR, and the SYSTEM 
CONFIGURATOR. The SYSTEM CONFIGURATOR is a Task which is 
requested by the Real-Time Monitor when the system is initially loaded. 



* Refer to ADVANCED Software Monitor Manual and Utility Programs Manual. 
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The CONFIGURATOR is an interactive program which asks the user several 
questions in order to tailor the RSX-15 EXECUTIVE to suit his partic- 
ular application and hardware configuration. The user is required to 
supply information such as the amount of core memory available, number 
of disk units and Teletypes, partition sizes and locations, common 
areas, and which I/O Device-units are in the system. Chapter Six 
discusses the SYSTEM CONFIGURATOR in greater detail. 
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CHAPTER TWO 
EXECUTIVE 

2.1 INTRODUCTION 

The RSX EXECUTIVE is the heart of the real-time operating system. 
It coordinates all activities in the system including Task scheduling, 
I/O supervision, resource allocation, and interactive operator communi- 
cation . 

The core memory of the RSX system is divided into partitions that are 
occupied by the Real-Time Monitor, Monitor Console Routine (MCR) 
Function Tasks, I/O Handler Tasks, user written Tasks (programs ) , and 
COMMON Blocks used for inter-Task communications. There is no limit 
to the number of core partitions and COMMON Blocks that can be defined 
except for the amount of core space available. All Tasks are then 
executed from these partitions allowing several programs to be in core 
at any given time (multiprogreimming) . Normally Tasks reside on 
the disk, and are brought into their partition (if unoccupied) only 
when requested, and release their partitions upon exit. However, 
when desirable, or necessary, a Task may be fixed in core, thereby 
dedicating a partition to a single Task, but assuring core availabil- 
ity and rapid response. Tasks that can tolerate a response time of 
100 milliseconds or more will normally be disk resident rather than 
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core resident. Since the Task Builder program allows a Task to con- 
sist of a resident program with a simple to very elaborate overlay 
structure, a Task can be both core and disk resident at the same time. 
The core resident program remains in core once the Task has been acti- 
vated, and overlay segments are requested when needed. Requested over- 
lay segments will be executed immediately if already in core, or 
brought in from disk overlaying the previous segment (s) and then 
executed. When a Task is built using the Task Builder program it can 
include any number of user written programs and be assigned any core 
partition (providing the partition was defined at system configuration 
time and is large enough to contain the Task) . The Task can also be 
assigned any run priority (which may be overridden at run time) from 1 
to 512 where 1 is the highest priority. 

Task execution occurs because of requests by the operator, requests 
from a currently executing Task, or by a predefined schedule*. 
Activated Tasks are defined in the system Active Task List and sched- 
uled Tasks are defined in the Clock Queue to be activated at a pre- 
defined time. Tasks can also be installed in the system on-line 
while other Tasks are currently executing. 

2.2 EXECUTIVE ORGANIZATION 
2.2.1 CORE AND DISK fWJAGEHENT 

Core memory in the RSX system is partitioned to allow several Tasks 
to be active at any given time. All core above the resident EXECUTIVE 
(first 4K) can be user specified into Partitions and COMMON Blocks 
during system configuration. All unspecified space above the first 
8K of core will then be used to create Partition Blocks and a reservoir 



The scheduling capabilities of RSX will be described later. 
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of empty nodes called the "Pool". Each node in the Pool consists of 
ten contiguous memory locations with internal pointers connecting the 
previous node to the next node resulting in a circular or double ended 
queue called a dequ^. The EXECUTIVE uses nodes to create linked lists 
containing system information. These nodes are removed from and re- 
turned to the Pool as needed. 

Since the Pool and Partition Blocks are needed to run, sufficient 
core above the lower 8K core should be left unspecified. Unspecified 
core below 8K (and above the EXECUTIVE) is unused. 

Partitions and SYSTEM COMMON Blocks^ are fixed at system configuration 
time and cannot be altered at run time. Tasks are built to execute in 
specific partitions, and, any number of Tasks may be built to execute 
in the same partition - 

A Partition containing an active Task cannot be used by other Tasks, 
regardless of priority, until that partition becomes available. When 
two or more requests for the same partition are made and the partition 
is occupied, the Task with the highest priority will be serviced first 
when the partition becomes available. An executing Task releases its 
partition once it EXITs to the EXECUTIVE. 

RSX uses the disk for storage of user written Tasks, MCR Function 
Tasks and data. Disk space is automatically allocated by the 
EXECUTIVE when Tasks are installed in the system. The remaining 
portions of the disk are available to the user. When a Task requires 
disk space to store data, it must request it through the EXECUTIVE 
via an ALLOCATE Directive. The actual allocation of disk space is 
performed in increments of 128j^q words of contiguous disk storage 
providing the user with true random access capability. The EXECUTIVE 
maintains a record of availeible disk space by using a bit map scheme. 
A user can relinquish allocated disk space through the use of the 



^ Deque is pronounced "deck". 
^See Glossary: COMMON BLOCK, SYSTEM. 

2-3 



DEALLOCATE Directive. 

2.2.2 SCHEDULING OF REAL-TIME PROGRAMS (TASKS) 

The scheduling of Real-Time programs (Tasks) can result from any one 
of three types of events: the request for the activation of a Task, 
the request for an Input/Output transfer, or the occurrence of a 
hardware interrupt. It is important that the reader have a thorough 
understanding of the meaning of "Significant Event" ^ and the Active 
Task List in order to understand the concepts of scheduling in RSX. 

The Active Task List is a priority ordered list of Active Tasks that 

is used to drive the system. This list is scanned from high to low 

priority by the EXECUTIVE as a result of a Significant Event to give 

control to the highest priority Task that is capable of executing at 
that time. 

Tasks are installed in the system either at the priority given them 
at Task Building time (default priority) or at the priority specified 
in the INSTALL Directive. For instance, the user can install a Task 
named SCAN with default priority 100 by typing: 

INSTALL SCAN 
If a new default priority of 78 were desired, the user could have in- 
stalled SCAN by typing: 

INSTALL SCAN 78 
Task priorities can also be altered at run time either by the operator 
or by a currently executing Task. Once a Task has been installed in 
the system it can be activated by typing: 

REQUEST SCAN (Task will execute at default 

priority) 

SCHEDULE SCAN 13:30:00 30M (Task will execute at default 

priority at 1:3J? P.M. and be resched- 
uled every 30 minutes thereafter) 

RUN SCAN 25M (Task will execute at default 
priority 25 minutes from now) 



^Task initiation, task completion, and I/O completion are examples of 
significant events. 
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SYNC SCAN H 30H 2H 78 (Task will be executed at priority 

78, 30 minutes past the hour, and 
every 2 hours thereafter) 

A request to activate a Task will be executed providing that a parti- 
tion is available and a Task with a higher priority is not currently 
executing. Once a Task is activated it will run to completion unless 
interrupted by a higher priority Task. An interrupted lower priority 
Task will be resumed only when higher priority Tasks have completed 
or have relinquished control. Whenever one Task is interrupted by 
another, its active registers are automatically saved by the 
EXECUTIVE and later restored when execution is resumed. Control will 
be given to a lower priority Task if a currently executing Task is 
waiting for the completion of an I/O request or by issuing any of the 
following Directives: WAIT; WAITFOR; and SUSPEND. Control can 
be given to a higher priority Task by requesting it to be run or by 
issuing any of the following Directives: REQUEST, RUN, SYNC, and 
SCHEDULE . 

The following example illustrates the mechanism used by the EXECUTIVE 
to scan the Active Task List. Assume that two Tasks are installed in 
the system with names TASKl and TASK2 and have priorities of 50 and 
100 respectively^. The operator requests TASKl to be executed one 
minute from now and TASK2 to be executed immediately. The operator's 
commands would be: 

RUN TASKl IM 

REQUEST TASK2 

The following chart describes the sequences of events durin" the 
request and activation of both Tasks. 



^The larger number indicates a lower priority. 
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TASK2 finishes ex- 
ecution and system 
is idle. 

TASK2 resximes execution 

at priority 100. 



TASKl exits. Monitor restores 
TASK2's registers and resumes 
execution of TASK2. 

^- 

TASKl executes at 
priority level 50. 



TASKi finishes 
execution. 



Monitor saves TASK2's registers 
and Clock routine activates TASKl. 



Process Clock Interrupt 
which occurs one minute 
after operator requested 
TASKl . 



TASK2 executes 
at priority 100. 



Monitor requests TASK2 



MCR Function 
processes request. 



Monitor requests 
MCR Function. 
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Process Keyboard Interrupts 



Operator requests 
TASK2 to be run 

immediately. 
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Monitor requests MCR 
Function which enters 
request in Clock Queue. 



Process Keyboard Interrupts 



Operator requests 
TASKl to be run one 
minute from now. 



System is idle. 
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2.2.3 INPUT/OUTPUT OPERATIONS 

The RSX EXECUTIVE allows the user device independent programming, 
reassignment of devices on-line, and the ability to queue I/O re- 
quests providing him with an extremely powerful and flexible I/O 
structure. 

The RSX system provides the user with device handlers for standard 
I/O devices supplied with the system. These handlers are called I/O 
Device Handler Tasks and can be installed in the system either at 
system configuration time or on-line. I/O Handler Tasks are connected 
to the user's environment by means of a logical/physical device re- 
lationship. This relationship allows the user to reference a Logical 
Unit Number (LUN) rather than a physical device when requesting an 
I/O operation. At run time the user then may reassign the LUN to the 
desired physical device. Thus, a Task which normally outputs data to 
LUN 4 which is currently assigned to the teleprinter can output the 
same results on a paper tape punch or line printer if the user types 
the following: 

REASSIGN k PP TTfl (Reassign LUN 4 to the Paper Tape 

(or) Punch from TTj2f) 

REA h LP PP (Reassign LUN 4 to the line printer 

from the Paper Tape Punch) 

All requests to be serviced by I/O Hemdler Tasks are entered into a 
priority ordered queue even though the device may be busy. The 
priority of the request will be the same as the priority of the Task 
issuing the request. Once the Task has issued a request, it can 
either wait for its completion or continue executing and test at any 
time the current state of the I/O operation it requested. 

An Event Variable (software flag) may be associated with I/O requests 
and its value indicates the current status of the I/O operation. When 
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an I/O operation completes, the user 'a Event Variable is set accord- 
ingly and a Significant Event is declared. This causes the Active 
Task List to be scanned and control to be given to the highest prior- 
ity Task capeible of executing. 

There are two types of I/O Device Handlers in the RSX System: The 
Standard I/O Device Handler Task and the System I/O Device Handler 
Task. The System I/O Handlers are the Disk and Multi-Teletype Handler 
Tasks which must be core resident and cannot be deleted from the 

system. Standard I/O Device Handler Tasks are those which are not 
System I/O Handlers supplied by the manufacturer or created by the user. 
When a LUN is assigned to a device* the Handler Task is requested and 
remains in core as long as the LUN is assigned to the device. 

A Task can obtain the exclusive use of an I/O Handler Task by issuing 

an ATTACH Directive. Vilien the ATTACH Directive is accepted by the 

Handler, only requests from that Task are serviced with requests from 

other Tasks queued until a DETACH request is serviced. 

Example: ATTACH 2,EV Attach the device assigned to LUN 

2 to the currently executing Task. 
DETACH 2,EV Detach the Device. EV is the event 

variable. 

2.2.4 DYNAMIC SYSTEM PRIORITY CONTROL 

The priority structure of the RSX System includes both hardware and 
software priority levels. Hardware levels are established by the 
Automatic Priority Interrupt (API) of the PDP-15 computer and soft- 
ware levels are established by the user and controlled by the 
EXECUTIVE. There are 8 levels of API of which four are used for hard- 
ware I/O devices and four for the EXECUTIVE. API levels 4 and 6 are 
used exclusively by the EXECUTIVE and level 7 is used for Task 
execution (level 5 is currently not used). From level 7, the 
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EXECUTIVE derives its 512 Task priority levels used for Task operations. 
The following figure illustrates the hierarchy of the entire priority 
system. 

AUTOMATIC PRIORITY INTERRUPT SYSTEM 



Task Priority Levels 



Derived from API 
level 7 by the 
Executive 



512 



■♦•l 



API 
LEVELS 



Executive Priority Levels 



Exclusive use by 
the Executive 



Hardware Levels 



Used by all 
I/O Devices 



3 2 10 



Increasing Priority 



Figure 2.2 RSX Priority Structure 

The hardware API levels 0,1,2, and 3 are used to control I/O devices 
in the system. Each level can have as many as 8 device controllers 
connected to it allowing a total of 32 devices to be serviced by the 
API system. Each of the 32 API lines are associated to unique core 
locations which specify where program control will be transferred 
when an interrupt signal occurs on that line. 



2-9 



CHAPTER THREE 

NCR 

MONITOR CONSOLE ROUTINE 

3.1 INTRODUCTION 

The Monitor Console Routine (MCR) allows the user to communicate on- 
line with the system from the console teleprinter to dynamically 
adjust and modify the operation of the system through simple commands 
(functions). The operator may obtain status information about the 
system, install or replace Tasks, request Task execution based upon 
time driven schedules, or fix a Task in core. Other MCR commands 
permit altering of logical/physical device relationships, excunination 
and modification of core locations, and adjustment of the System Clock 
and Calendar. 

The MCR consists of the Resident MCR Task, which accepts the user's 
commands, and the MCR Functions, which actually carry out the indi- 
cated requests. The MCR Functions are similiar to user created Tasks 
in that they normally reside on the disk and are brought into a core 
partition when requested. Although the MCR Functions are built (with 
the Task Builder) to execute in a predefined core partition, they 
can be built to run in any partition. Execution of MCR Tasks, like 
all Tasks, is based upon partition availeibility and Task priority. 
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3.1.1 REQUESTING THE RESIDENT MCR 

The Resident MCR must be Active in order to receive requests for 
Function Tasks from the operator at the console teleprinter. To 
request the Resident MCR, type CTRL C (i.e., simultaneously depressing 
the CTRL and C keys) . When the MCR is ready to accept a command it 
will output: 

MCR> 
(on LUN 2) and wait for a command to be typed immediately to the right 
of the prompting character {>) 

3.1.2 ERROR DETECTION AND HANDLING 

Error detection is provided by the various MCR Functions and Resident 
MCR where applicable. When an error is detected, an appropriate 
message, prefixed by the neime of the issuing MCR Function, is output 
to LUN 3. 

3.1.3 COHilAND STRINGS 

When typing MCR conmiand strings the following conventions apply: 

a. Command strings are terminated either by a Carriage RETURN 
or by an ALT MODE. If a Carriage RETURN is typed, the 
Resident MCR will be requested when the current Function is 
complete. If an ALT MODE is typed, the Resident MCR will 
not be requested at the termination of the current Function. 

b. Each element of a command string must be separated by either 
a comma { , ) or a space (_) . 

c. If an error is discovered while typing a command string prior 
to typing a terminator, the line may be deleted as far back 
as the prompting character (>) by typing CTRL U (formed by 
simultaneously typing CTRL and U characters) . A commercial 
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d. 



"at" (@) symbol is echoed informing the user that he can 
retype the command string. The RUBOUT, echoed as a 
backslash ( \ ) , may be used to delete the last character 
typed in. Every time the RUBOUT is typed, a backslash is 
echoed and a character is deleted. 

Any nvunber of characters (except a comma or space) may be 
inserted between a Function name and its arguments or command 
string terminator (Carriage RETURN or ALT MODE) . This is 
useful if the user wishes to improve the readability of his 
teleprinter copy. 



3.2 SUMMARY OF liCR FUNCTIONS' 



Task Name 
ETI(MEJ 
TIM[E] 
DAT[E] 

TAS[K LIST] 
PARfTITIONS] 
COM[MON BLOCKS] 

DEV[ICES AND ASSIGNMENTS] 

INS [TALL] 

REM[OVE] 

REQ[UEST] 

SCK[EDULE] 
RUN 



Function 

Enter time and date into the system. 

Request current time from the system. 

Request current date and time from 
the system. 

Request System Task List. 

Request list of Partition definitions. 

Request list of Common Block defini- 
tions . 

Request list of LUN device assign- 
ments . 

Install a Task in the system. 

Remove a Task from the system. 

Request immediate activation of a 

Task. 



Request scheduled Task a delta time 
from now. 



* Square brackets of the form ( [ ] ) specify optional characters . 
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SYN[C] 

CAN[CEL] 
RES[UME] 
FIX 

UNF[IX] 
DIS[ABLE] 

ENA[BLE] 
REA[SSIGN] 
SAV[E] 
OPE [N] 



Schedule and synchronize the activa- 
tion of a Task. 

Cancel the activation of a Task. 

Resume execution of a suspended Task. 

Fix Task in core (Task becomes core 
resident) . 

Unfix Task in core. 

Disable Task (reject future Task 
activation directives) . 

Enable a disabled Task. 

Change LUN assignment (s) . 

Save image of core on the disk. 

Open register for examination or 
modification. 



3.3 MCR FUNCTION DESCRIPTIONS 

The following paragraphs describe the form and function of the MCR 

Functions. To simplify the interpretation of the various command 

strings, the following symbols are used to represent the non-printing 

teleprinter operations : 

; = Carriage RETURN 

+ = LINE FEED 

7 = Terminator (either Carriage Return or ALT MODE) 

_ = Space 

Square brackets of the form ([]) specify optional characters and/or 

arguments. The ampersand sign (&) is used for concatenation of a 

numeric argument to an alphabetic letter. 

3.3.1 ENTER TIME 

The Enter Time Function is used to set the System Clock and Calendar. 

Form: ETI [ME] _Hr :Min: Sec [_Mo/Day/Yr] V 

Variables :Hr = Hours (0-23) 

Min = Minutes (0-59) 
Sec = Seconds (0-59) 
Mo = Month (1-12) 
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Day = Day of Month (1-31) 

Yr = Year (last two digits ^-99) 

NOTE: The European form has the month and day reversed. 

Example: The time is 30 seconds past 3:45 P.M. and the date is 
March 23, 197.1. 

riCR>ETIME 15:45:30 3/23/71 



3.3.2 TIME 

The Time Function outputs the time of day on LUN 3. 
Form: TIM[E]V 
Example: The time is 41 seconds past 3:45 P.M. 



MCR>TIKE 
15;45;41 

MCR> 



3.3.3 DATE 

The Date Function outputs the System Calendar and the time of day on 

LUN 3. 

Form: DAT[E]7 

Example: The date is March 23, 1971 and time of day is 52 seconds 
past 3:45 P.M. 

MCR>DATE 

03/23/71 15:45:52 

MCR> 

3.3.^ TASK LIST 

The Task List Function outputs to LUN 3 a description of each Task 
which has been Installed in the system. The description consists of 
the following information (printed left to right, one line per Task) : 
Task Name, Partition Name, Priority (decimal) , Disk Unit Number 
(octal) , Head Track Address (octal) and Task Size (octal) . Output 
may be prematurely terminated by typing CTRL C. 
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Form: TAS[K LIST]V 










Example : 












•'1CR>TASK 


LIST 










RX 


P14.S 


512 





102200 


00530 


PP.... 


10.2 


002 





101200 


00617 


DT. ... 


10. 1 


002 





076600 


02261 


PR.... 


10.2 


002 





075600 


00736 


LP.... 


10.2 


001 


3 


075000 


00463 


...DAT 


fICR 


002 





074600 


00176 




. . . OPE 


MCR 


902 


3 


073600 


00624 




. . . SAV 


MCR 


002 





073200 


00214 




,..W.\ 


NCR 


032 





072000 


01040 




...DIS 


MCR 


002 





071600 


00166 




. . . RAR 


MCR 


002 





071400 


00166 




...UNF 


MCR 


002 





071000 


00211 




...FIX 


MCR 


002 





070400 


00302 




...RES 


ricR 


032 





070000 


00250 




...CAN 


MCR 


002 





067600 


00166 




...SYN 


ilCR 


002 





067200 


00377 




. . RU M 


MCR 


002 





066600 


00361 




..SCH 


MCR 


002 





366000 


00407 




..REQ 


MCR 


002 





065400 


00335 




..REM 


MCR 


002 





065000 


00305 




.. INS 


MCR 


302 





063200 


01516 




..DEV 


MCR 


002 





062400 


00533 




..COM 


MCR 


002 





062000 


00263 




..PAR 


MCR 


002 





061400 


00230 




..TAS 


MCR 


002 





060600 


00406 




..TIM 


MCR 


002 





063400 


00145 




..ETI 


MCR 


002 


a 


060000 


00350 


MC 


:r> 













3.3.5 PARTITIONS 

The Partition Function outputs to LUN 3 a description of all core 
partitions defined in the system. The description consists of (printed 
from left to right, one line per partition): Partition Name, Parti- 
tion Base Address (octal) , and Partition Size (octal) . Output may 
be prematurely terminated by typing CTRL C. 
Form: PAR[TITI0NS]7 
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Excuaole : 



>5CR>PARTITI0NS 



f^CR 


10300 


01600 


10. 1 


11600 


03000 


P14.6 


14600 


05 200 


P21.0 


21000 


05500 


P26.5 


26500 


06500 


10.2 


35200 


01000 


P40.0 


40000 


15000 


MCR> 







3.3.6 COMMON BLOCKS 

The COMMON Blocks Function outputs to LUN 3 a description of all 
System COMMON Blocks defined in the system. The description consists 
of (printed from left to right, one line per COMMON Block) : COMMON 
Block Name, COMMON Block Base Address (octal), and COMMON Block Size 
(octal). Output may be prematurely terminated by typing CTRL C. 

Form : COM [MON_BLOCKS ] V 

Example : 



■MCR> COMMON BLOCKS 
.XX 20000 00730 

FLAG 36230 00600 

'1CR> 
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3.3.7 DEVICES AND ASSIGNMENTS 

The Devices and Assignments Function outputs to LUN 3 a list of phys- 
ical device units and the Logical Unit Numbers assigned to them. 
Output may be prematurely terminated by typing CTRL C. 

Form : DEV [ ICES_AND_ASSIGNMENTS ] 7 

Example : 






nEVICEF AMD ASSIGNMENTS 

1 

2,3, 5, 10, 11, 12, 13,! 4, 15, 1 6, 17, 18, 19 

?P!, 2 1,22, 23, 24, 25,26, 27, 28,29,30, 31 
32 



TTl 

DT3 
DTI 
DT2 
DT3 
nT4 
DT5 
PT6 
DT7 

PPPI 

LP0 

MCP> 



7 
Q 



3.3.8 INSTALL 



The Install Function is used to input a Task into the RSX System. 

The Task to be added must be a binary file (TSK extension) produced 

by the Task Builder. TSK files are installed from LUN 5. 

Form : INS [ TALL ] _TSKNAM [ _P ] V 

Variables :TSKNAM = Name of Task to be Installed (1-6 characters) 
P = Task priority (1 - 512) 

Examples: Install Task SCAN whose default priority defined at 
Task Building time is 48. 



MCR>INS SCANj 

(or) 
MCR>INS SCAN 10j 



(SCAN is now redefined 
with a priority of 10) 
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3.3.9 REfiOVE 

The Remove Function is used to delete a Task from the RSX System. 

Form: REM[OVE]_TSKNAMV 

Variables :TSKNAM = Name of Task to be Removed (1-6 characters) 

Example: The Task SCAN is no longer required and it is desired 
to remove it from the System. 
MCR>REM SCANj 

3.3.10 REQUEST 

The Request Function is used to request the execution of a Task at an 
indicated software priority level. Actual Task execution depends upon 
priority and partition availability. 

Form: REQ[UEST]_TSKNAM[_Pl? 

Variables :TSKNAM = Name of Task (1-6 characters) 
P = Task priority (1 - 512) 

Examples: Request the execution of SCAN whose default priority 
defined at Task Building or Installation time is 48. 
MCR>REQ SCAN; 

(or) 
MCR>REQ SCAN 10j (SCAN is requested with 

a priority of 10) 

3.3.11 SCHEDULE 

The Schedule Function is used to schedule the execution of a Task at 

some time in the future, specified in time-of-day, at an indicated 

software priority level, and with periodic rescheduling. 

Form: SCH[EDULE]_TSKNAM_Hr:Min:Sec[_RI&RU] [_P]V 

Variables :TSKNAM = Name of Task (1-6 characters) 
Hr = Hours (0 - 23) 
Min = Minutes {0 — 59) 
Sec = Seconds {0 - 59) 

RI = Reschedule Interval (up to 1 day) 
RU = Reschedule Units (T=Ticks, S=Seconds, M=Minutes, 

and H=Hours) 
P = Task Priority (1 - 512) 

Examples: Schedule the execution of SCAN at 1:30 P.M. eaid resched- 
ule it every 30 minutes thereafter at its default 
priority. 
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MCR>SCH SCAN 13:3ff:00 30Mj 

Schedule the execution of SCAN at 8:3^ A.M. and resched- 
ule it every 2/6jJth's of a second {6St cycle clock) at 
priority level Ijt. 

MCR>SCH SCAN 8:30:0)3 2T 10; 



3.3.12 RUN 

The Run Function is used to make a Task active at some future time, 

specified in delta time from now, at an indicated software priority 

and with periodic rescheduling. 

Form: RUN_TSKNAM_SI&SU[_RI&RU] [_PJV 

Variables : TSKNAM = Name of Task (1-6 characters) 

SI = Schedule Interval (up to one day) 

SU = Schedule Units (T=Ticks, S=Seconds, M=Minutes, 

and H=Hours) 
RI = Reschedule Interval (up to one day) 
RO = Reschedule Units (T=Ticks, S=Seconds, M= 

Minutes, and H=Hours) 
P = Task Priority (1 - 512) 

Examples: Schedule the execution of SCAN 3^ minutes from now and 
reschedule it every hour thereafter. 

MCR>RUN SCAN 30M IH; 

Schedule the execution of SCAN 10 minutes from now and 
reschedule it every 32 seconds thereafter at priority 
level 28. 

MCR>RUN SCAN 10M 32S 28j 



3.3.13 SYNCHRONIZE 

The Sync Function is used to activate a Task at some future time 
following the occurrence of the next tick, second, minute, or hour. 
The Task is executed at the indicated software priority and with 
periodic rescheduling. This Function is particularly useful for 
minimizing the peak loading of a system which can occur when many 
Tasks are scheduled for execution at the same time. 
Form: SYN[C]_TSKNAM_SZ_SI&SUl_RI&RU] [_P]7 
Variables: TSKNAM = Neune of Task (1 to 6 characters) 
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SZ = Synchronization Units (T=Ticks, S=Seconds, M= 

Minutes, and H=Hours) 
SI = Schedule Interval from Synchronization time 

(up to one day) 
SU = Schedule Units (T=Ticks, S^Seconds, M=sMinutes, 

and H^Hours) 
RI = Reschedule Interval (up to one day) 
RU = Reschedule Units (T=Ticks, S=Seconds, M=Minutes, 

and H=Hours) 
P = Task Priority (1 - 512) 

Example: Schedule the execution of SCAN 3 minutes after the next 
hour and reschedule it every hour thereafter at its 
default priority level. 

MCR>SYN SCAN H 3M IHj 

Schedule the execution of SCAN 10 seconds after the next 
minute and reschedule it every hour thereafter at prior- 
ity 21. 

MCR>SYN SCAN M 105 IH 21j 



3.3.W CANCEL 

The Cancel Function is used to cancel all scheduled requests for 
activation of a particular Task by removing those requests from the 
Clock Queue. Cancellation does not affect the current execution of 
the given Task nor does it affect schedule requests made in the 
future. The latter case is covered by the DISABLE Function. However, 
schedule requests which have already been made (and entered in the 
Clock Queue) are discarded. 

Form: CAN[CEL]_TSKNAMV 

Variables :TSKNAM = Name of Task (1-6 characters) 

Example: Cancel the activation of Task SCAN. 
MCR>CAN SCANj 

3.3.15 RESUME 

The Resume Function is used to resume the execution of a Task which 
has been SUSPEND 'ed. 

Form: RES [UME]_TSKNAMI Resumption address] V 
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Variables :TSKNAM = Name of Task (1-6 characters) 

Example: Task SCAN has been previously SUSPEND 'ed and it is 
desired to resume its execution. 

MCR>RES SCANj 



3.3.16 FIX IN CORE 

The Fix Function is used to fix an inactive Task into a free partition. 
This dedicates a partition to a Task and provides for a faster response 
to the REQUEST, SCHEDULE, RUN, and SYNC Directives as well as responses 
to external interrupts. 

Form: FIX_TSKNAM7 

Variables :TSKNAM = Name of Task (1-6 characters) 

Example: Fix Task SCAN in core. 
MCR>FIX SCAN; 

3.3.17 UNFIX FROM CORE 

The Unfix Function is used to nullify a FIX Directive. If a FIXed 
Task is active when an UNFIX Directive is issued, the partition will 
be freed when the Task EXITs. 

Form : UNF [ IX ] _TSKNAMV 

Variables :TSKNAM = Ncime of Task (1-6 characters) 

Example: Unfix Task SCAN from its partition. 
MCR>UNF SCAN; 

3.3.18 DISABLE 

The Disable Function is used to instruct the system to reject further 
REQUEST, SCHEDULE, RUN, or SYNC Directives or periodic rescheduling 
for an indicated Task. This Function renders the specified Task in- 
capable of responding to other Directives except ENABLE. A Disabled 
Task is not deleted from the system. (cf. REMOVE.) 
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Form : DIS [ABLE ] _TSKNAM7 

Variables :TSKNAM = Name of Task (1-6 characters) 
Example: Disable the Task SCAN. 
MCR>DIS SCANj 

3.3.19 ENABLE 

The Enable Function is used to re-enable a DISABLEd Task. 

Form : ENA [ BLE ] _TSKNAMV 

Variables :TSKNAM = Name of Task (1-6 characters) 

Example: Task SCAN has been previously DISABLEd and it is desired 
to re-enable it* 

MCR>ENA SCAN. 



3.3.20 REASSIGN 

The Reassign Function is used to alter the logical/physical device 

relationships by deassigning a Logical Unit Number (LUN) from a device 

and reassigning it to another device. This Function causes the 

REQUESTing and EXITing of I/O Device Handler Tasks. 

Form: REA[SSIGN]_LUN_ND_OD[/LUN_ND_OD] [/LUN_ND_OD] V 

Variables: LUN = Logical Unit Number to be Reassigned 

ND = Device to which the LUN is to be assigned 

OD = Device from which the LUN is to be deassigned. 

Examples: Assume the following LUN assignments currently exist: 
LUN 25TT)J, LUN 3=TT/J, LUN 4=DT5, and LUN 33£LP. It is 
now desired toreassign those LUN's to the following 
devices: LUN 2=TT1, LUN 3=TT1, LUN 4=DT7, and LUN 33=TTjJ. 

MCR>REA 3 TTl TJfi, 

MCR>REA 2 TTl Tr0j 

MCR>REA tf DT7 DT5j 
.'■1CR>REA 33 TTp LPj 

(or) 

MCR>REA 2 TTl TT/3 TTl TTj 

MCR>REA tt DT7 DT5/33 TT LPj 

Note: The MCR Functions, including the REASSIGN Function, 
use LUN's 2 and 3 for command input and output, 
respectively. Therefore, it is recommended when 
the user REASSIGN 's these to another device, he 
should do so by REASSIGNing both LUN's on the same 
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line as shown in the second set of examples. The 
first set of examples are valid when altering 
LUN's 2 and 3 because the output from the REASSIGN 
Function Task was altered first and further com- 
mands can still be input from LUN 2. Device names 
associated with I/O Handler Tasks provided with 
the system are: 

TT[n] = Teletype (n is the unit number which, if omitted, 

will be assumed zero) 

DT[n] = DEC tape 

DK = DECdisk 

PR = High Speed Paper Tape Reader 

PP = High Speed Paper Tape Punch 

LP = Line Printer 



3.3.21 SAVE 

The Save Function is used to record a core image of an RSX System 
(from location 3j?g to the top of core memory) at the beginning of disk 
zero. The purpose of this Function is to provide a means for updating 
the system after Tasks have been added or deleted. The updated system 
can then be restored at any time by simply loading the RSX Bootstrap. 
This Function should only be executed when the system is quiescent, 
i.e., no Tasks should be active and no I/O should be in progress.^ 
Since the entire RSX system is recorded on the disk, when the user 
reloads the system, the System Calendar and clock will reflect the 
previous settings at the time the Save was done. Therefore the user 
should reset them to the correct date and time after reloading the 
system. 

Form: SAV[E]V 

Example: Save a copy of the RSX system on disk zero. 
MCR>SAV[Elj 

3.3.22 OPEN REGISTER 

The Open Register Function permits the user to access any core location 
for the purpose of examination and/or modification. The user may 
optionally enter a signed number in any opened location using either 



^The former does not imply the latter. 
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octal or decimal notation. Furthermore he may open and examine the 

register whose address is specified by the low order 15 bits of the 

currently open register or he may continue examination either in 

ascending or descending address order. 

Form: OPE[N]_ADR[ Dn] V 

Variables: ADR = Address of location to be examined. If 

the specified address is valid, the address and 
contents of that register are output followed by 
the prompting character (>). 

D = The letter "D" signifies a disk address (ADR) 
rather than a core address to open. 

n = Disk unit nvmiber. 

Note: User's response follows the prompting character 
(>). The (|) symbol denotes "EXCLUSIVE OR". 



Fori 



ADDRSSS/CONTSNTS>[new contents] } t*Vl | [tV] 



Variables: new contents = A number (1-6 digits) which is to re- 
place the contents of the currently opened 
register. The number may be optionally 
signed (+ or -) and/or a radix operator 
(D = decimal, = octal). 

EXAMPLES: Decimal -39 

-D39 (or) -T>fS00jll39 

Octal 32 

032 (or) +032 (or) 32 



Terminators 
following: 



and special characters may be any of the 



Example : 



- Close the current register and open the 

next higher register. 
ALT MODE - Close the current register and terminate 

the Function. 
+; - Close the current register and open the 

next lower register. 
*j - Close the current register and open the 

register specified by the lower 15 bits 

of the current register. 

Comments follow the slash character and are used only to 
describe the different operations. 



MCR>OPE 2«t2j 
>002't2/!J02325j 
>002H3/io03^32*j 
>ii3'*32/000050 00001*7] 

>03'i33/000'i32 -D10CALT MODE) 



MCR>OPE 2'f3j 
>002'iJ/003^32i 
>0^2'f2/0|if2325 
MCR> 



J 



■6 CALT MODE) 



/open register 242 
/open register 243 
/open register 3432 
/change contents of 
/ 3432 to 47. 
/change contents of 
/ 3433 to -Ij? decimal 
/ and terminate 
/ sequence . 
/open register 243 
/open register 242 
/change contents to -6 
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CHAPTER FOUR 
RSX SYSTEM DIRECTIVES 

4.1 INTRODUCTION 

Communication to the RSX System from the user is accomplished by the 
use of system "Directives". Directives may be issued from within a 
Task or indirectly by an operator via the teleprinter and the Monitor 
Console Routine (MCR) . The manner in which a Directive may be issued 
varies according to its function and use. 

Directive routines are structured to be reentrant and may be used to 
direct the Executive to schedule and reschedule a Task, provide status 
information for a Task, or queue I/O Handler Tasks to perform indicat- 
ed I/O operations. 

4.2 SUMMARY OF RSX DIRECTIVES & SYSTEM MACROS 



RSX DIRECTIVES 



CAL FUNCTION 


MACRO 


FORTRAN 


CODE (octal) 


CALL 


CALL 


n 


REQUEST 


REQST 


n 


SCHEDULE 


SCHED 


n 


RUN 


RUN 


14 


SYNC 


SYNC 


H 


CANCEL 


CANCEL 


06 


SUSPEND 


SUSPND 


J?7 


RESUME 


RESUME 



SYSTEM DIRECTIVE 



Request Task execution 
Schedule Task execution 
Run Task in delta time 
Sync Task execution 
Cancel scheduled requests 
Suspend Task execution 
Resume Task execution 
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13 
20 

05 

lJ2f 
11 
12 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
21 
22 
15 
16 



MARK MARK 
WAITFOR WAITFR 
WAIT WAIT 



EXIT 

CONNECT 

DISCONNECT 

READ 

WRITE 

DSKAL 

DSKDAL 

DSKPUT 

DSKGET 

ATTACH 

DETACH 

SEEK 

ENTER 

DELETE 

CLOSE 

HINF 

DISABLE 

ENABLE 

FIX 

UNFIX 



EXIT 



READ 

WRITE 

DSKAL 

DSKDAL 

DSKPUT 

DSKGET 

ATTACH 

DETACH 

SEEK 

ENTER 

DELETE 

CLOSE 

HINF 

DISABL 

ENABLE 

FIX 

UNFIX 



Set Event Variable in delta 

time 
Wait for an Event Variable to 

be set 
Wait for next Significant 

Event 
Terminate execution of the Task 
Connect to interrupt line 
Disconnect from interrupt line 
Read from I/O Handler Task 
Write to I/O Handler Task 
Allocate disk storage 
Deallocate disk storage 
Put data on disk 
Get data from disk 
Attach Device-Unit to a Task 
Detach Device-Unit from a Task 
Seek file 
Enter file 
Delete file 
Close file 
Handler information 
Disable Task 
Enable Task 
Fix Task in core 
Unfix Task in core 



MACRO 
CALL 

DECLAR 

TIME 

DATE 

INTENTRY 

INTEXIT 



SYSTEM MACROS 

FORTRAN SYSTEM FUNCTION 
CALL 



DECLAR 

TIME 

DATE 



Declare a Significant Event 
Obtain Time from Executive 
Obtain Time and Date from 

Executive 
Interrupt Entry (register save 

routine) 
Interrupt Exit {register restore 

routine) 



4.3 DESCRIPTION OF DIRECTIVES 

The RSX Directives are implemented as CAL instructions* which point 
to argument blocks (CAL Parameter Blocks ) . As a convenience to the 
assembly language programmer, the Directives have been defined as 
macro instructions and are commonly referred to as System Macros. 
FORTRAN Tasks use Directives through standard CALL statements to a 
group of FORTRAN Library Routines which themselves issue the Directives. 



* See Glossary 
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The RSX System allows Task names of one to six characters in length, 
however, not more than five characters may be used in Task names in 
FORTRAN calls in order to comply with PDP-15 FORTRAN conventions. 

Most Macro and FORTRAN calls to RSX Directives include the Task 
priority and its Event Variable (EV) . The Task priority is indicated 
by a decimal number between 1 (highest priority) and 512 (lowest pri- 
ority) . A priority value of zero instructs the Executive that the 
Task's default priority is to be used. Directives usually have EV's 
associated with them which provide information concerning the results 
after the issuance of the Directive. If an EV is not specified 
when issuing a Directive, the Executive does not attempt to provide 
any information concerning the operation. Event Variables are set 
positive upon successful completion, zero when the request is pending, 
and negative to indicate rejection or failure. Appendix D provides 
a complete list and explanation of the EV values returned by the 
system. 

In the following sections which describe the Directives, square brackets 
of the form ([]) are used to specify optional arguments. 

4.3.1 REQUEST ■, 

This Directive instructs the Executive to initiate the execution of a 
Task based on an indicated software priority. The actual execution 
depends upon the priority and partition availability. The Event Var- 
iable, or the Event Variable and priority, may be omitted. A Task 
cannot request itself. REQUEST may be issued from an interrupt service 
routine. Event Variables returned are: +1, -201, -2pf2, -204, and -777. 

SYSTEM MACRO : REQUESTJTSKNAM [ , P I , EV] ] 

Variables: TSKNAM = Name of Task (1-6 characters) 
P = Task Priority (1 -512) 
EV = Event Variable Address 
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Examples: Request the execution of SCAN whose default priority 
is 48. 

REQUEST SCAN,0,EV 

(or) 
REQUEST SCAN, its, EV 

Request the execution of SCAN at a priority of 20. 

REQUEST SCAN, 20, EV 

(or) 
REQUEST SCAN, 20 /In this case the testing of the 

/Event Variable is not desired. 

FORTRAN CALL : CALL_REQST (nHTSKNAM , IP [ , lEV] ) 

Variables: n = Number of characters in Task Name 
TSKNAM = Name of Task (1-5 characters) 
IP = Task Priority (1 - 512) May be either a 

Variable name or a direct constant. 
lEV = Event Variable 

Examples: Request the execution of SCAN whose default priority is 
48. 

CALL REQST CtHSCAN, 0, I EV) 

(or) 
IP=it8 
CALL REQST CtHSCAN, IP, I EV) 

Request the execution of SCAN at default priority and 
no Event Variable is desired. 

CALL REQST C^HSCAN,0) 



^.3.2 SCHEDULE 

This Directive instructs the Executive to initiate the execution of a 
Task at an absolute time of day and to reactivate it continuously at 
a specified interval thereafter based on the indicated priority. If 
the Reschedule Interval is zero, the Task is executed only once at the 
time of day specified. A Task may SCHEDULE itself, however, the 
SCHEDULE Directive may not be issued from an interrupt service routine. 
Event Variables returned are: +1, -2^1, -2J?3, -2J?4, and -777. 

SYSTEM MACRO: SCHEDULE_TSKNAM,SH,SM,SSr ,RI,RUl ,PI ,EV] ] ] 

Variables: TSKNAM = Name of Task (1-6 characters) 
SH = Schedule Hour {0 - 23) 
SM = Schedule Minute {0 - 59) 
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SS = Schedule Second {0 - 59) 

RI = Reschedule Interval (up to one day) 

RU = Reschedule Units (l=Ticks, 2=Seconds, 

3=Minutes, and 4=Hours) 
P = Task Priority (1 - 512) 
EV = Event Variable Address 

Examples: Schedule Task SCAN to run at 4:3j2f P.M. and every 5 min- 
utes thereafter at a priority of 20SS. 

SCHEDULE SCAN, 16, 30, 0,5, 3^200, EV 
(or) 

SCHEDULE SCAN, 16,30,0,5,3 /If Task's default 

/priority was 200 and 
/Event Variable was 
/not desired. 

Schedule Task ALPHA to run at its default priority at 
7:15 A.M. with no rescheduling and no Event Variable. 

SCHEDULE ALPHA, 7, 15 

FORTRAN CALL : CALL_SCHED (nHTSKNAM , IT , IP [ , lEV] ) 

Variables: n = Number of characters in Task Name 
TSKNAM = Name of Task (1-5 characters) 
IT = Name of 5 word (integer) array to describe 
the time of scheduling and rescheduling. 
The array is described below: 

IT(1) = Schedule Hour (0-23) 

IT (2) = Schedule Minute {0 - 59) 

IT (3) = Schedule Second {0 - 59) 

IT (4) = Reschedule Interval (up to one 

day) 
IT (5) = Reschedule Units (l=Ticks, 
2=Seconds, 3=Minutes, and 
4=Hours) 
IP = Task Priority (1 - 512) 
lEV = Event Variable 

Examples: This example is equivalent to the first example in this 
section using FORTRAN. 

DIMENSION ITC5) 
ITCD = 16 
ITC2) = 30 
IT(3) = 
ITCt) = 5 
ITC5) = 3 

ID — orirt 

lEV =0 

CALL SCHED(%HSCAN,IT,IP,IEV) 

(or) 
CALL SCHED('tHSCAN,IT,200,IEV) 

Schedule SCAN as above with no Event Variable and at its 
default priority. 

IP = 

CALL SCHEDCtHSCAN,!!,!?) 
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To schedule SCAN only once, set the reschedule interval 
equal to zero. 

ITCt) = 
IP =0 
CALL SCHEDC4H5CAN, IT,IP) 



4.3.3 RUN 

This Directive instructs the Executive to initiate the execution of a 
Task at a specified time interval from the time that the Directive is 
issued and reactivate the Task continuously at a specified interval 
thereafter. If the Reschedule Interval is zero, the Task is executed 
only once. A Task may use this Directive to reschedule itself, but 
the Directive may not be issued from an interrupt service routine. 
Event Variables returned are: +1, -201, -2j?3, -2^4, and -777. 

SYSTEM MACRO : RUN_TSKNAM , SD , SUl , RI , RU I , P [ , EV] ] ] 

Variables: TSKNAM = Name of Task (1-6 characters) 

SD = Schedule Delta time from now (up to one 

day) 
SU = Delta Units (l=Ticks, 2=Seconds, 3=Minutes, 

and 4=Hours) 
RI = Reschedule Interval (up to one day) 
RU = Reschedule Units (l=Ticks, 2=Seconds, 

3=Minutes, and 4=Hours) 
P = Task Priority (1 - 512) 
EV = Event Variable Address 

Examples: Run the Task INITS 5 seconds from now and every 10 
minutes thereafter at priority of 512. 

RUN INITS, 5, 2, 10, 3, 512, EV 

Run the same Task at its default priority with no 
Event Variable specified. 

RUN INITS, 5, 2, 10,3 

FORTRAN CALL : CALL_RUN (nHTSKNAM , IT , IP [ , lEV] ) 

Variables: n = Number of characters in Task Name 
TSKNAM = Name of Task (1-5 characters) 
IT = Name of 4 word (integer) array to describe 
the time of scheduling and rescheduling. 
The array is described below: 

IT(1) = Schedule Delta time from now 
(up to one day) 



4-6 



IT (2) = Delta Schedule Units (l=Ticks, 

2=Seconds , 3=Minutes , and 

4=Hours) 
IT (3) = Reschedule Interval (up to one 

day) 
IT (4) = Reschedule Units (l=Ticks, 

2=Seconds , 3=Minutes , and 

4=Hours) 
IP = Task Priority (1 - 512) 
lEV = Event Variable 

Example: Run the Task INITS 5 seconds from now and every 10 
minutes thereafter at a priority of 512. 

DIMENSION IT(it) 

ITCl) = 5 

ITC2) = 2 

ITC3) = 10 

ITC4) =3 

IP - 512 

CALL RUNC5HINITS,IT,IP,IEV) 



i\.5A SYNC 

This Directive causes the Executive to execute a Task at a specified 
interval after the next hour, minute, second, or tick and to reinitiate 
the Task continuously at a specified interval. 

A Schedule Delta Time value of zero causes the named Task to be start- 
ed on the next occurrence of the Synchronization Unit. A Reschedule 
Interval of zero causes the Task to be executed only once. This Di- 
rective may not be issued from an interrupt service routine. A Task 
may use SYNC to reschedule itself. Event Variables returned are: +1, 
-201, -2i?3, -2J2f4, and -777'. 

SYSTEM MACRO : SYNC_TSKNAM , S Z , SD , SU I , RI , RU I , P I , EV] ] ] 

Variables: TSKNAM = Name of Task (1-6 characters) 

SZ = Synchronization Units (l=Ticks, 2=Seconds, 

3=Minutes, and 4=Hours) 
SD = Schedule Interval from synchronization 

time (up to one day) 
SU = Schedule Units (l=Ticks, 2=Seconds, 

3=Minutes, and 4=Hours) 
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RI = Reschedule Interval (up to one day) 
RU = Reschedule Units {l=Ticks, 2=Seconds, 

3=Minutes, and 4=Hours) 
P = Task Priority (1 - 512) 
EV = Event Variable Address 

Examples: Assuming the time is now 14:27:47, run Task FRED at 
14:28:j?9 at a priority of 20 and reschedule it every 
4 minutes thereafter. 

SYNC FRED,3,9,2,4,3,20,SYNEV 

Schedule the execution of SCAN 10 seconds after the next 
minute mark and reschedule it every hour thereafter at 
priority 21. 

SYNC SCAN,3,10,2,l,'t,21,SYNEV 

FORTRAN CALL : CALL_SYNC (nHTSKNAM , IT , IP [ , lEV] ) 

Variables: n = Number of characters in Task Name 
TSKNAM = Name of Task (1-5 characters) 
IT = Name of 5 word (integer) array to describe 
the time of synchronization, scheduling, 
and rescheduling. The array is described 
below: 

IT(1) = Synchronization Units (l=Ticks, 
2=Seconds, 3=Minutes and 
4=Hours) 
IT (2) = Schedule Interval from synchro- 
nization time (up to one day) 
IT (3) = Schedule Units {l=Ticks, 
2=Seconds , 3=Minutes , and 
4=Hours) 
IT (4) = Reschedule Interval (up to one 

day) 
IT(5) = Reschedule Units (l=Ticks, 
2=Seconds, 3=Minutes, and 
4=Hours) 
IP = Task Priority (1 - 512) 
lEV = Event Variable 

Examples : Schedule the execution of Tasks FRED and SCAN as 
described in the examples for the System Macros. 

INTEGER FREDEV,SCANEV,SCANP,FREDP 

DIMENSION ITC5) 

ITCO = 3 

ITC2) = 9 

ITC3) = 2 

ITC^f) = 4 

ITC5) = 3 

FREDEV = 

FREDP = 20 

CALL SYNCCtHFRED, IT, FREDP, FREDEV) 
SCANEV = 
SCANP = 21 
ITC2) = 10 
IT(^) = 1 
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iTC5) = h 

12 CALL SYNCCtHSCAN^IT^SCANP^SCANEV) 

C INSURE BOTH SYNC REQUESTS WERE ACCEPTED 

IFCSCANEV.OR.FREDEV.LT.0) GO TO 10 
C BOTH SYNC REQUESTS WERE ACCEPTED AT THIS POINT 



C REPORT FAILURE OF SYNC REQUESTS TO BE ACCEPTED TO 
CONSOLE OPERATOR. 

10 WRITEC5j,ll) 

11 FORMATC32H TASKS FRED OR SCAN NOT SYNCED.//) 
STOP 

END 



4.3.5 CANCEL 

This Directive instructs the Executive to remove all entries which 
appear in the Clock Queue for a specified Task. Cancel may not be 
issued from an interrupt service routine and has no effect on an 
active Task. Event Variables returned are: +1 and -2^1. 

SYSTEM MACRO: CANCEL_TSKNAM[ ,EV] 

Variables: TSKNAM = Name of Task (1-6 characters) 
EV = Event Variable Address 

Example: Cancel the activation of Task SCAN. 

CANCEL SCAN,EV 

FORTRAN CALL : CALLjCANCEL (nHTSKNAM [ , lEV] ) 

Variables: n = Number of characters in Task Name 
TSKNAM = Name of Task (1-5 characters) 
lEV = Event Variable 

Example: Cancel the activation of Task SCAN 

CALL CANCEL(4HSCAN,IEV) 

il.3.6 SUSPEND 

This Directive instructs the Executive to suspend execution of the 
Task issuing this Directive. The Task remains active in its core 
partition but execution is not permitted until the system receives a 
RESUME Directive. The Executive ignores this Directive if it is 
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issued from an interrupt service routine. 

SYSTEM MACRO: SUSPEND 
FORTRAN CALL: CALL SUSPND 

4.3.7 RESUME 

This Directive instructs the Executive to resume execution of a Task 
which has been SUSPENDed. Task execution continues either at a spec- 
ified Resumption Address or, if not specified, at the address inraiediate- 
ly following the SUSPEND Directive. Event Variables returned are: +1, 
-2J32, and -2J?5. 

SYSTEM MACRO: RESUME_TSKNAM [ ,RA [ ,EV] ] 

Variables: TSKNAM = Name of Task (1-6 characters) 
RA = Resumption Address (octal) 
EV = Event Variable Address 

Example: Resume Task TSKA at location RSTRT. 

RESUME TSKA^RSTRT,EVA 

FORTRAN CALL: CALL_RESUMB (nHTSKNAM [ , lEV] ) 

Variables : n = Number of characters in Task Name 
TSKNAM = Name of Task (1-5 characters) 
lEV = Event Variable 

Example: Resume Task TSKA. 

CALL RESUMECtHTSKA^IEV) 

Note: The RESUME subroutine permits a SUSPENDed Task 
to resume only at the location immediately 
following the CALL SUSPND statement. 

4.3.8 MARK 

This Directive instructs the Executive to clear a specified Event 
Variable and set it to a non-zero value after a specified time inter- 
val has elapsed. If the request is accepted, the Event Variable is 



4-10 



cleared. After the specified interval has elapsed, the Event Varia- 
ble is set to +1 and a Significant Event is declared. The user may 
test the Event Variable as desired. The time interval indicates time 
from the execution of the Directive. The Mark Directive is ignored 
if issued from an interrupt service routine. Event Variables returned 
are: +1, -2i3f3, and -777. 

SYSTEM MACRO: MARK_MI , MU , EV 

Variables: MI = Delta Interval {up to one day) 

MU = Delta Units (l=Tick.s, 2=Seconds, 3=Minutes, 

and 4=Hours) 
EV = Event Variable Address 

Example: Set Event Variable TSTEV 5 minutes from now. 

MARK 5, 3, TSTEV 

FORTRAN CALL: CALLJ1ARK(IT,IEV) 

Variables: IT = Name of 2 word (integer) array to describe 

the time. The array is described below: 
IT(1) = Delta Interval (up to one day) 
IT (2) = Delta Units (l=Ticks, 2=Seconds, 
3=Minutes, and 4=Hours) 
lEV = Event Variable 

Example: Same as above example except in FORTRAN. 

DIMENSION IT(2) 

ITCl) = 5 

IT(2) = 3 

CALL MARK(IT,IEV) 

^.3.9 WAITFOR 

This Directive instructs the Executive to examine a specified Event 
Variable and, if zero, suspend execution of the issuing Task until 
the Event Variable is found to be non— zero. The Event Variable is 
examined at each occurrence of a Significant Event. Once a non-zero 
value is detected, the suspended Task is resumed (contingent on pri- 
ority) at the address immediately following the Directive CCAL) . If 
WAITFOR is issued from an interrupt service routine, it will be ignored. 
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SYSTEM MACRO: WAITFOR_EV 

Variables: EV = Event Variable Address 

Example: In this example, the Mark Directive requests that an 

Event Variable (MRKEV) be zeroed for 5 minutes and then 
set non-zero. The WAITFOR detects the fact that the 
Event Variable is zero and suspends Task execution un- 
til the value becomes non-zero (i.e., in 5 minutes). 
The Task is then resumed at the instruction immediately 
following the WAITFOR. 

MARK 5, 3, MRKEV 
WAITFOR MRKEV 

FORTRAN CALL: CALL_WAITFR (lEV) 

Variables: lEV = Event Variable 

Example: Same as preceding example except in FORTRAN. 

DIMENSION IT.(2) 
ITCO = 5 
ITC2) = 3 
C lEV WILL AUTOMATICALLY BE CLEARED BY MARK 
CALL MARKCIT,IEV) 
CALL WAITFRCIEV) 



4.3.10 WAIT 

This Directive instructs the Executive to suspend execution of the 

issuing Task until the next Significant Event occurs. The Task is re- 
sumed (contingent upon priority) at the next Significant Event and con= 
tinues at the location immediately following the WAIT. It is the 
responsibility of the Task issuing the WAIT to determine the meaningful- 
ness of the Significant Event which caused it to be resumed. This 
Directive is ignored if issued from an interrupt service routine. 

SYSTEM MACRO: WAIT 
FORTRAN CALL: CALL_WAIT 

it. 3. 11 EXIT 

This Directive causes the Executive to terminate execution of the 
issuing Task. If the issuing Task is not fixed-in-core (via FIX) the 
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core partition occupied by the Task becomes available to other Tasks. 
This Directive should not be issued until all transfers to the par- 
tition (e.g. I/O transfers, Task-to-Task transfers. Event Variable 
settings, etc.) have been completed. This Directive is ignored if 
issued from an interrupt service routine. 

SYSTEM MACRO: EXIT 
FORTRAN CALL: CALL_EXIT 

4.3.12 CONNECT 

This Directive instructs the Executive to create a linkage between a 
specified API (Automatic Priority Interrupt) trap address and a spe- 
cified entry point to an interrupt service routine (there is one trap 
address for each of the 32 API lines in the PDP-15) . Event Variables 
returned are: +1, -3)2fl, and -3^2. The following is a list of API 
line assignments 



LINE NUMBER DEVICE 



LINE NUMBER DEVICE 



04 


DECtape 


24 


Diskpack 


05 


Magtape 


25 


Plotter 


06 


(unused) 


26 


(unused) 


(3f7 


(unused ) 


27 


(unused) 


10 


Paper Tape Reader 


30 


(unused) 


11 


*Clock 


31 


UDC15 


12 


Power Failure 


32 


AFC15 


13 


Memory Parity 


33 


(unused) 


14 


VP15 Display 


34 


*LT15/LT19 Printers 


15 


Card Reader 


35 


*LT15/LT19 Keyboards 


16 


Line Printer 


36 


DECtape (additional) 


17 


A/D Converter 


37 


Dataphone (additional ) 


20 


Interprocessor Buffer 


4J2f 


♦Console TTY (Key- 
board) 


21 


(unused) 


41 


♦Console TTY (Print- 


22 


Dataphone 


42 


er J 

Paper Tape Punch 


23 


*Disk 


43 


Memory Protect 



*These lines are always connected to the system. 
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SYSTEM MACRO: CONNECT_LN , CL [ , EV] 

Variables: LN = Interrupt line Number (octal) 

CL = Entry Address of interrupt service routine 
EV - Event Variable Address 

Example: Connect an interrupt service routine for an A/D Converter 
(entry point called ADINT) to interrupt line 31. 

CONNECT 31, ADINT, ADEV 

FORTRAN CALL: No subroutine is provided for this Directive since 
FORTRAN is not an appropriate language for writing 
interrupt handling routines. 



4.3.13 DISCONNECT 

This Directive instructs the Executive to remove the linkage created 
between an Automatic Priority Interrupt trap address and an interrupt 
service routine entry by the CONNECT Directive. Event Variables 
returned are: +1, -3J?1, and -3|?2. 



SYSTEM MACRO: DISCONNECT_LN,CL,EV 

Variables: LN = Interrupt Line Number (octal) 

CL = Entry Address of interrupt service routine 
EV = Event Variable Address 

Example: Disconnect the A/D Converter from interrupt line 31. 

DISCONNECT 3 1 , ADINT, ADEV 

FORTRAN CALL: No subroutine is provided for this Directive since 
FORTRAN is not an appropriate language for writing 
interrupt handling routines. 



4.3.14 READ 

READ generates a form of the QUEUE I/O Directive which causes input 
of formatted ASCII or Binary to a specified buffer via the I/O Device 
Handler Task assigned to the indicated Logical Unit Number. The 
Event Variable specified is set to zero when the request is accepted 
and subsequently is set to an appropriate value indicating the status 
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of the operation. Event Variables returned are: +2, +1, -5, -7, -11, 
-12, -16, -23, -lj2fl, -102, -103, and -777. 

SYSTEM MACRO: READ LUN, MODE, BUFF, SIZE [ ,EV] 



Variables ; 



Example : 



LUN = Logical Unit Number (decimal) 

MODE = I/O Data Mode (J3=I0PS BINARY, 1= IMAGE 

BINARY, 2=I0PS ASCII, and 3=IMAGE ASCII) 
BUFF = Starting Address of user's buffer 
SIZE = Maximvim number of words to transfer (octal) 
EV = Event Variable Address 

Read 256 (decimal) words in lOPS ASCII from the device 
assi-^ned to LUN 3 and store them in a buffer called TXTBF. 



READ 3,2,TXTBF,it02,INDEV 

FORTRAN CALL: No subroutine is necessary to implement this Direc- 
tive. The standard READ statement as described in 
the PDP-15 FORTRAN IV Manual is used. 

Example: DIMENSION TXTBF(256) 
READ (3,10) TXTBF 
10 FORMATC256A1) 



ii.5.15 WRITE 

WRITE generates a form of the QUEUE I/O Directive which causes output 
of formatted ASCII or Binary from a specified buffer to the I/O Device 
Handler Task assigned to the indicated Logical Unit Number. The Event 
Variable specified is set to zero when the request is accepted and 
subsequently set to an appropriate value indicating the status of the 
operation. Event Variables returned are: +2, +1, -6, -7, -11, -12, 
-15, -16, -23, -lJ2fl, -lj?2, -103, and -777. 



SYSTEM MACRO: 
Variables: 



WRITE_LUN , MODE , BUFF I , EV] 

LUN = Logical Unit Number (decimal) 

MODE = I/O Data Mode (0=IOPS BINARY, 1=IMAGE 

BINARY, 2=I0PS ASCII, and 3=IMAGE ASCII) 
BUFF = Starting Address of user's buffer 
SIZE = Maximum number of words to transfer (octal) 
EV = Event Variable Address 
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FORTRAN CALL: No subroutine is necessary to implement this Direc- 
tive. The standard WRITE statement as described in 
the PDP-15 FORTRAN IV Manual is used. 

Example: DIMENSION TXTBF(2 56) 
WRITEC6,10)TXTBF 
10 FORMATC256M) 

Write out "WARNING, XFC OSCILLATING AT" followed by a 
frequency on LUN 3. 

WRITE(3,10)IFQ 
10 FORMATC28H WARNING, XFC OSCILLATING AT, 16//) 



4.3.16 DSKAL 

DSKAL generates a form of the QUEUE I/O Directive to reserve a disk 
storage area of a specified size. If the space is available, the 
starting address, physical disk number, and actual amount of space 
allocated^ (in increments of 128 decimal words) is returned to a 
Control Table which is contained within the issuing Task or in a 
COMMON Block. The actual allocation does not occur instantaneously; 
hence> one must test the Event Variable to determine completion. 
Event Variables returned are: +1, -15, -1^4, and -777. 

SYSTEM MACRO: DSKAL_CTB [ ,EV] 

Variables: CTB = Address of a Control Table of the 

following format: 

Word 1: Desired amount of disk 

storage which is replaced 

by the actual amount allocated 

if allocated. 

Word 2: Physical disk unit number 
(returned at completion of 
operation) . 

Word 3 : Absolute starting address of 
the space allocated relative 
to the physical disk unit 
number (returned at completion 
of the operation) . 

EV = Event Variable address 



^ which may exceed the amount requested. 
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Example: Request 7^^ decimal words of disk storage. (Since 

allocation is given in increments of 128 decimal words, 
the actual allocation will be 768 decimal words.) 



LAC (1274) 
DAC CTB+0 
DSKAL CTB,EV 
WAITFOR EV 



/SETUP FIRST WD OF CONT TBL. 

/REQUEST ALLOCATION OF 700 
/WORDS OF DISK STORAGE. 



FORTRAN CALL: 
Variables: 



CALL_DSKAL ( ICTB , NW [ , lEV] ) 

ICTB = Control Table (integer array) . The Control 
Table is described below: 

Word 1: Actual amount of space al- 
located (returned at comple- 
tion of the operation) . 

Word 2: Physical disk unit number 
(returned at completion of 
operation) . 

Word 3: Absolute starting address of 
the space allocated relative 
to the physical disk unit 
number (returned at completion 
of the operation) . 
lEV = Event Variable 
NW = Desired storage in words 



Example: Same as above except in FORTRAN. 

DIMENSION ICTB (3) 

CALL DSKAL (ICTB , 700 , IDKEV) 

CALL WAITFR (IDKEV) 

Note: Space will not be allocated across disk unit 
bounds (i.e., from one unit to another). No 
more than 13^1,944 words may be allocated by a 
single DSKAL command. 



4.3.17 DSKDAL 

DSKDAL generates a form of the QUEUE I/O Directive to release a disk 
storage area, which had previously been allocated by DSKAL, from the 
Disk. Event Variables returned are: +1, -15, -lJ2f4, and 
-777. 



SYSTEM MACRO: 
Variables : 



DSKDAL CTB[,EV] 



CTB 



EV 



= Control Table Address. This address should 
be the same as that used by DSKAL which 
originally allocated the space. 

= Event Variable Address 
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Example: Request deallocation of the disk storage allocated 
in the previous section. There is no concern for 
when the disk space is actually freed. 

DSKDAL CTB 



FORTRAN CALL : CALL_DSKDAL (ICTB J , lEV] ) 

Variables:. ICTB = Control Table tinteger array). This address 

should be the same as that used by DSKAL 
which originally allocated the space. 
lEV = Event Variable 

Example: Same as above except in FORTRAN 

DIMENSION ICTB(3) 

CALL DSKDALCICTB, lEV) 



4.3.18 DSKPUT 

DSKPUT generates a form of the QUEUE I/O Directive to output data onto 
the disk from a specified area in core. This Directive is used when 
total freedom in data structuring and random access capabilities are 
desired. Event Variables returned are: +1 and -N, where N is the 
contents of the disk status register if a disk error occurs. 

SYSTEM MACRO : DSKPUT_CTB [ , EV] 

Variables : CTB = Address of a Control Table of the 

following format: 



Word 1 
Word 2 
Word 3 
Word 4 



EV = Event Variable address 



Disk unit number 
Starting address on disk 
Starting address in core 
Length of transfer in words 
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FORTRAN CALL: 
Variables: 



CALL bSKPUT (ICTA, IOA,NW, ARRAY [ ,IEVj ) 



ICTA 



lOA 



NW 
ARRAY 

lEV 



Device Control Table (integer array) . 
This array must be the same as that used 
to allocate the space onto which the data 
is being written since this uses infor- 
mation in the Control Table obtained via 
DSKAL 

Disk offset address. The relative position 
(in words) within an array at which the 
transfer to the disk is to begin. 
Number of words (decimal) to transfer. 
The name of the array containing the data 
to be transferred. 
Event Variable 



Example: Allocate 128^ decimal words of disk storage and write 
out 256 words on the disk from BUF. Writing on disk 
is to begin 128 words beyond the starting address of 
the beginning of the disk storage area. 



DIMENSION ICTAC3),BUFC256) 

CALL DSKAL(ICTA;1280,IDKEV) 

CALL WAITFRCIDKEV) 

CALL DSKPUT(ICTA,12 8,2 56,BUF,IDKEV) 



^.3.19 DSKGET 

DSKGET generates a form of the QUEUE I/O Directive to read data from 
the disk into a specified area in core. This Directive is used where 
total freedom in data structuring and random access capabilities are 
desired. Event Variables returned are: +1 and -N, where N is the 
contents of the disk status register if a disk error occurs. 



SYSTEM MACRO: 
Variables : 



DSKGET CTB[,EV] 



CTB 



= Address of a Control Table of the 
following format: 

Word 1; Disk unit number 



Word 2 
Word 3 
Word 4 



EV 



Starting address on disk 
Starting address in core 
length of transfer in words 



= Event Variable address 
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FORTRAN CALL: CALL_DSKGET (ICTA,IOA,NW, ARRAY [, lEV] ) 

Variables : ICTA = Device Control Table (integer array) . 

Array must be the same as that used to 
allocate the space from which the data 
is being read since this uses information 
in the Control Table obtained via DSKAL. 

lOA = Disk offset address. The relative position 
(in words) within an array at which the 
transfer from the disk is to begin. 

NW = Number of words (decimal) to transfer. 

ARRAY = The name of the array where data is to be 
transferred. 

lEV = Event Variable 

Example: Allocate 512 decimal words of disk storage and later 
read in the last 256 decimal words into BUF. 

DIMENSION ICTAC3),BUFC256) 
CALL DSKAL C I CTA, 512 , lEV) 
CALL WAITFRCIEV) 

CALL DSKGETCICTA,256,256,BUF,IEV) 



Example: This final FORTRAN example allocates 1024 words of disk 
storage, writes 256 words from four different arrays, later reads 
the last array of 256 words, and then deallocates the disk space 
and EXITS. 



COMMON BUF2(128) ,ICTA(3) ,BUF1(128) ,BUF3(128) ,BUF4(128) 

C 

C ALLOCATE lp(24 WORDS OF DISK STORAGE 

C 

CALL DSKAL (ICTA, lJ2r24 , lEV) 

CALL WAITFR (lEV) 
C 

C INSURE ALLOCATION WAS MADE 

C 

IF (lEV .GT. J2f) GO TO 2J2( 
C 

C STORAGE NOT ALLOCATED, TYPE MESSAGE & EXIT 

C 

WRITE (3,lJ2f) 
lj2f FORMAT (2jZ(H ALLOCATION NOT MADE) 

CALL EXIT 
C 

C ALLOCATION MADE, WRITE OUT ARRAYS 

C 

2i2f CALL DSKPUT (ICTA, 0, 256 ,BUF1 , lEV) 

CALL DSKCK (lEV) 

CALL DSKPUT (ICTA, 256 , 256 ,BUF2 , lEV) 

CALL DSKCK (lEV) 

CALL DSKPUT (ICTA, 512 , 512 ,BUF3 , lEV) 

CALL DSKCK (lEV) 
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c 

C READ IN LAST ARRAY FROM DISK 

C 

CALL DSKGET (ICTA, 768, 256 ,BUF4, lEV) 

CALL DSKCK (lEV) 



C 

C RELEASE DISK SPACE & EXIT 



C 



CALL DSKDAL (ICTA) 
STOP 

END 



SUBROUTINE DSKCK (lEV) 

CALL WAITER (lEV) 

IF (lEV .LT. j?) GO TO 10 

RETURN 

10 WRITE (3,2J?) 

20 FORMAT (IIH DISK ERROR) 

CALL EXIT 
END 



4-21 



4.3.20 ATTACH 

ATTACH generates a form of the QUEUE I/O Directive which requests the 
exclusive use of an I/O device. Once the Directive is accepted, no 
other Task may use the device regardless of priority. All requests 
by other Tasks, however, will be queued and processed whenever the 
device becomes free (DETACHED). The REASSIGN MCR Function, however, 
overrides the ATTACH. Event Variables returned are: +1, -6, -24, 
-101, -102, -103, and -777. 

SYSTEM MACRO : ATTACH_LUN [ , EV] 

Variables: LUN = Logical Unit Number (decimal) 
EV = Event Variable Address 

Example: Attach device assigned to LUN 32. 

ATTACH 32,ATEV 

FORTRAN CALL : CALL_ATTACH ( LUN [ , lEV ] ) 

Variables : LUN = Logical Unit Number 
lEV = Event Variable 

Example: Same as above except in FORTRAN. 

CALL ATTACH(32,IEV) 

4.3.21 DETACH 

DETACH generates a form of the QUEUE I/O Directive which releases a 
device from the exclusive use of the issuing Task. Previous 
requests which were queued by the I/O Handler Task while ATTACHed will 
now be processed. The Task issuing the DETACH Directive must be the 
Task which ATTACHed the device. Event Variables returned are: +1, 
-6, -101, -102, -103, and -777. 

SYSTEM MACRO: DETACH_LUN [ ,EV] 

Variables: LUN = Logical Unit Nvimber (decimal) 
EV = Event Variable Address 
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Example: Detach device assigned to LUN 23. 

DETACH 2 3,DTEV 

FORTRAN CALL : CALL_DETACH (LUN [ , lEV] ) 

Variables: LUN = Logical Unit Number 
lEV = Event Variable 

Example: Same as above except in FORTRAN. 

CALL DETACHC23,IEV) 

4.3.22 SEEK (OPEN FILE FOR INPUT) 

SEEK generates a form of the QUEUE I/O Directive which requests the 
I/O Handler Task assigned to the indicated Logical Unit Number to 
search the device's file directory for a specified file name. This 
Directive is used to initiate file-oriented transfers using the READ 
Directive. Once the SEEK has been accepted by the I/O device, it 
effectively attaches the LUN to the issuing Task. Event Variables 
returned are: +1, -6, -Ij?, -12, -13, -101, -102, -ljZ(3, and -777. 

SYSTEM MACRO: SEEK_LUN,FLNAM,EXT[ ,EV] 

Variables: LUN = Logical Unit Number 

FLNAM = File name (1-6 characters) 

EXT = File name extension (1-3 characters) 

EV = Event Variable Address 

Example: Search the directory of the file-oriented device 
associated with LUN 6 for a file named DATA SRC. 

SEEK 6, DATA, SRC, EV 

FORTRAN CALL : CALL_SEEK (LUN , nHFLNAM , nHEXT [ , lEV] ) 

Variables: LUN = Logical Unit Number 

n = Number of characters in file name or 

extension. 
FLNAM = File Name (1-5 characters) 
EXT = File Name Extension (1-3 characters) 
lEV = Event Variable 

Example: Same as above except in FORTRAN. 

CALL SEEK(5,'tHDATA,3HSRC,IEV) 
C WAIT FOR SEEK TO COMPLETE 
CALL WAITFRCIEV) 
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4.3.23 ENTER (OPEN FILE FOR OUTPUT) 

ENTER generates a form of the QUEUE I/O Directive which requests the 

I/O Handler Task assigned to the indicated Logical Unit Number to 

search the device's file directory for a free Directory Entry Block 

in which to place the file name specified. This Directive is issued 

prior to issuing a WRITE Directive to a file-oriented device. The 

actual recording of the file name does not occur until the CLOSE. 

Once the ENTER has been accepted by the I/O device, it effectively 

attaches the LUN to the issuing Task. Event Variables returned are: 

+1, -6, -IjH, -12, -14, -15, -Ij?!, -lj?2, -lJ2f3, and -777. 

SYSTEM MACRO: ENTER_LUN,FLNAM,EXT[ ,EV] 

Variables: LUN = Logical Unit Number (decimal) 

FLNAM = Pile Name (1-6 characters) 

EXT = File Name Extension (1-3 characters) 

EV = Event Variable Address 

Example: Enter into the directory of the file-oriented device 
associated with LUN 6 the file name DATA SRC. 

ENTER 6, DATA, SRC, EV 

FORTRAN CALL : CALL_ENTER (LUN , nHFLNAM , nHEXT [ , lEV] ) 

Variables : LUN = Logical Unit Number 

n = Number of characters in file name or 

extension. 
FLNAM = File Name (1-5 characters) 
EXT = File Name Extension (1-3 characters) 
lEV = Event Variable 

Example: Same as above except in FORTRAN. 

CALL ENTER(6,'tHDATA,3HSRC, lEV) 

^.3.2l^ DELETE 

DELETE generates a form of the QUEUE I/O Directive which requests the 
I/O Handler Task assigned to the indicated Logical Unit Number to re- 
move the indicated file name from the device's file directory. Event 
Variables returned are: +1, -6, -1/3, -12, -IjZfl, -1912, -1JJ3, and -777. 
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SYSTEM MACRO: DELETE_LUN , PLNAM , EXT [ , EV] 

Variables: LUN = Logical Unit Number (decimal) 

FLNAM = File Name (1-6 characters) 

EXT = File Name Extension (1-3 characters) 

EV = Event Variable Address 

Example: Delete the file DATA SRC from the directory of the file- 
oriented device associated with LUN 6 . 

DELETE 6, DATA, SRC, EV 

FORTRAN CALL : CALL_DELETE (LUN , nHFLNAM , nHEXT [ , lEV] ) 

Variables: LUN = Logical Unit Number 

n = Number of characters in file name or 

extension. 
FLNAM = File Name (1-5 characters) 
EXT File Name Extension (1-3 characters) 
lEV = Event Variable 

Example: Same as above except in FORTRAN. 

CALL DELETEC6,'iHDATA,3HSRC,IEV) 



i|.3.25 CLOSE 

CLOSE generates a form of the QUEUE I/O Directive which instructs the 

appropriate I/O Handler Task that the issuing Task has completed an 

I/O operation to the named file which resides on the device. Once a 

CLOSE is issued, subsequent transfers to or from the CLOSEd file are 

not possible until an appropriate SEEK or ENTER is again issued. Event 

Variables returned are: +1, -6, -11, -12, -15, -1J2(1, -li2'2, -103, 

and -777. 

SYSTEM MACRO: CLO SE_LUN, FLNAM, EXT [ ,EV] 

Variables: LUN = Logical Unit Number (decimal) 

FLNAM = File Name (1-6 characters) 

EXT = File Name Extension (1-3 characters) 

EV = Event Variable Address 

Example: Close the file DATA SRC on the file-oriented device 
associated with LUN .6 . 

CLOSE 6, DATA, SRC, EV 

FORTRAN CALL : CALL CLOSE (LUN , nHFLNAM , nHEXT [ , lEV] ) 
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Variables: LUN = Logical Unit Number 

n = Number of characters in file name or 

extension. 
FLNAM = File Name (1-5 characters) 
EXT = File Name Extension (1-3 characters) 
lEV = Event Variable 

Example: Same as above except in FORTRAN. 

CALL CLOSEC6,'tHDATA,3HSRC, lEV) 

4.3.26 HANDLER INFORMATION 



This Directive provides rudimentary information about the physical 
device and the I/O handler associated with a particular Logical Unit 
Number (LUN) . Handler information is coded into a single word, which 
is stored in the requestor's Event Variable as follows: 



Bit 



Bit 1 



Bit 



Bit 



Bits 4 
thru 
11 

Bits 12 
thru 
17 



UNUSED This bit is unused to allow a handler to 
return a value of -6 if this function was 
not implemented. 

INPUT Set to 1 if data can be input from the 
device to the computer. 

OUTPUT Set to 1 if data can be output from the 
computer to the device. 

FILE-ORIENTED Set to 1 if the I/O handler treats 

the device as being "file-oriented". 
A deviee is "file-oriented" if SEEK and 
ENTER are required prior to READ and 
WRITE, respectively. "File-oriented" 
implies, but does not guarantee, the 
existence of a file directory or that the 
device is bulk or mass storage. 



UNIT 



Unit number. 



DEVICE CODE These six bits allow up to 63 decimal 
devices (zero is not a legal device 
code) . The codes listed below are fixed 
for standard DEC devices. Users should 
assign codes to their own devices starting 
with 63 and working towards lower numbers. 



TT 



2 


DK - 


3 


DP - 


4 


DT - 


5 


MT - 



- The TTY terminals (console, LT15, 
and LT19) 

- The RF15 fixed-head DECdisk 

- The RP02 disk pack 

- The TC02D DECtape 

- The TC59 MAGtape 
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6 PR — The PC15 Paper Tape Reader 

7 CD — The CR^3B Card Reader 

10 pp — The PCI 5 Paper Tape Punch 

11 LP — The LP15 Line Printer 

12 VP — The VP15 Storage Scope 

13 VT — The VT15 Display 

SYSTEM MACRO: HINF_LUN,EV 

Variables: LUN = Logical Unit Number (decimal) 
EV = Event Variable Address 

FORTRAN CALL: CALL_HINF (LUN, lEV) 

Variables: LUN = Logical Unit Number 
lEV = Event Variable 



4.3.27 DISABLE 

This Directive causes the Executive to render the specified Task in- 
capable of responding to other Directives except ENABLE. The Task 
is not deleted from the system. If the Task is active, it will con- 
tinue to execute, however, schedule activations for that Task will 

be ignored when they come due. When the Task is subsequently ENABLEd, 

previously established rescheduling for the Task will continue in 

effect. Event Variables are: +1 and -2(2fl. 

SYSTEM MACRO: DISABLE_TSKNAM[ ,EV] 

Variables: TSKNAM = Name of Task (1-6 characters) 
EV = Event Variable Address 

Example: Disable Task named SCAN. 

DISABLE SCAN,EV 

FORTRAN CALL : CALL_D I SABL ( nHTS KNAM [ , IE V ] ) 

Variables : n = Number of characters in Task Name 
TSKNAM = Name of Task (1-5 characters) 
lEV = Event Variable 

Example: Same as above except in FORTRAN. 

CALL DISABLC'tHSCAN,IEV) 
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4.3.28 ENABLE 

This Directive causes the Executive to restore the specified Task to 
its normal state (i.e., as it was before DISABLE was issued). Event 
Variables returned are: +1 and -2J2(1. 

SYSTEM MACRO: ENABLE_TSKNAM[ ,EV] 

Variables: TSKNAM = Name of Task (1-6 characters) 
EV = Event Variable Address 

Example: Enable Task SCAN which is currently disabled. 

ENABLE SCAN,EV 

FORTRAN CALL : CALL_ENABLE (nHTSKNAM [ , lEV] ) 

Variables: n = Number of characters in Task Name 
TSKNAM = Name of Task (1-5 characters) 
lEV = Event Variable 

Example: Same as above except in FORTRAN. 

CALL ENABLEC4HSCAN,IEV) 

4.3.29 FIX 

This Directive instructs the system to load an inactive Task into an 
available partition. The Task is not executed, but is fixed-in-core 
and may therefore respond rapidly to a request for execution. FIX 
does not wait for a Task to be loaded before setting EV to +1. The 
Directive may not be issued to an active Task. Event Variables re- 
turned are: +1, -2JI1, -2J2f2, -2j?4, -207, and -21)?. 

SYSTEM MACRO: FIX_TSKNAM[ ,EV] 

Variables: TSKNAM = Name of Task (1-6 characters) 
EV = Event Variable Address 

FORTRAN CALL: CALL FIX (nHTSKNAM (, lEV] ) 
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Variables: n = Number of characters in Task Name 
TSKNAM = Name of Task (1-5 characters) 
lEV = Event Variable 



4.3.30 UNFIX 

This Directive instructs the Executive to nullify a FIX Directive 
thereby freeing a partition for use by other Tasks. If UNFIX is issued 
to a Task which is currently running, the Task will be allowed to run 
to completion before the Directive becomes effective. Event Variables 
returned are: +1, -201, and -207. 

SYSTEM MACRO: UNFIX_TSKNAM[ ,EV] 

Variables: TSKNAM = Name of Task (1-6 characters) 
EV = Event Variable Address 

FORTRAN CALL : CALLJJNFIX (nHTSKNAM [ , lEV] ) 

Variables: n = Number of characters in Task Name 
TSKNAM = Name of Task (1-5 characters) 
lEV = Event Variable 

4.3.31 DECLARE A SIGNIFICANT EVENT 

The DECLAR Directive provides the means for declaring to the Executive 
that a Significant Event has occurred. The occurrence of a Significant 
Event signals the Executive to initiate a scan of the Active Task List 
with control passing to the Task having the highest priority. DECLAR 
is particularly useful for intertask signalling and synchronization. 

SYSTEM MACRO: DECLAR 
FORTRAN CALL: CALL_DECLAR 

4.3.32 TIME 

The TIME System Macro and FORTRAN subroutine obtain the time of day 
from the Executive ' s internal clock and deposit these values in three 
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locations specified by the issuing Task. 



SYSTEM tmCRO: 
Variables: 

FORTRAN CALL: 
Variables: 



TIME_Hr ,Min , Sec 

Hr = Hours (0 
Min = Minutes (0 
Sec = Seconds (0 

CALL TIME(ITIME) 



23) 
59) 
59) 



ITIME = Three word Integer array as follows; 
ITIME(l) = Hours {0 - 23) 
ITIME (2) = Minutes (0 - 59) 
ITIME (3) = Seconds (0 - 59) 



4.3.33 DATE 

The DATE System Macro and FORTRAN subroutine obtain the current time 
(hours, minutes, and seconds) and date (month, day, and year) from the 
Executive ' s internal clock and calendar . The values obtained are de- 
posited in six locations specified by the issuing Task. 



SYSTEM MACRO 


: DATE_ 


_Hr,Min,Sec,N 


Ion,D( 


ay,Y 


Variables : 


Mon 


= Month 


(1 - 


12) 




Day 


= Day 


(1 - 


31) 




Yr 


= Year 


(0 - 


99) 




Hr 


= Hours 


(0 - 


23) 




Min 


= Minutes 


(0 - 


59) 




Sec 


= Seconds 


(0 - 


59) 



FORTRAN CALL: 
Variables : 



Note: The month and day reversed in European 
format . 

CALL_DATE (IDATE) 

IDATE = Six word Integer array as follows : 

IDATE (1) = Month (1 - 12) 

IDATE (2) = Day (1 - 31) 

IDATE (3) = Year (0 - 99) 

IDATE (4) = Hours (0 - 23) 

IDATE (5) = Minutes (0 - 59) 

IDATE (6) = Secnnds (0 - 59) 



4.3.34 INTENTRY 

The INTENTRY System Macro results in an entry to the Executive ' s Register 
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Save Routine. The Save Routine obtains the current contents of all 
active system registers, including the AC, Index and Limit Registers, 
first four Autoincrement Registers, and deposits them in a save area 
created by the Macro Assembler during expansion of the System Macro. 
This Directive may only be issued from within an interrupt service 
routine and must be the first instruction of the interrupt routine. 
The saved registers are restored by execution of the INTEXIT Directive. 
Appendix E provides a listing of all registers which are saved. 

SYSTEM MACRO: INTENTRYjCL 

Variable: CL = Interrupt service routine entry address. 

(connect location) 
FORTRAN CALL: No subroutine is provided to implement this since 

FORTRAN is not an appropriate language for writing 

interrupt handling routines. 

Example: See example in next section (4.3.35) 

4.3.35 INTEXIT 

The INTEXIT System Macro results in an entry into the Executive's 
Register Restore Routine. This routine restores all active registers 
saved by the INTENTRY Directive, Debreaks, and returns to the inter- 
rupted Task. INTEXIT may only be issued from within an interrupt 
service routine. 

SYSTEM MACRO: INTEXITjCL 

Variable: CL = Interrupt service routine entry address 

(connect location) 
FORTRAN CALL: No subroutine is provided to implement this since 

FORTRAN is not an appropriate language for writing 

interrupt handling routines. 

Example: An interrupt service routine named AD INT for an A/D 
Converter is to use the INTENTRY and INTEXIT System 
Macros. 
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INTENTRY ADINT /MUST BE PLACED AT THE ENTRANCE 

/ TO THE INTERRUPT ROUTINE. 

[ /SECTION TO SERVICE INTERRUPT. 

INTEXIT ADINT /RESTORE REGISTERS, DEBREAK, 

/ AND RETURN TO INTERRUPTED 
/ TASK. 
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CHAPTER FIVE 
TASK BUILDER 

5.1 INTRODUCTION 

The TASK BUILDER program, TKB, is an ADVANCED Software System's pro- 
gram used to build user's Tasks from relocatable binary files. TKB 
is quite similar to the CHAIN program allowing very elaborate overlay 
structures to be built. 

The process of Task building is one where relocatable binary files are 
linked together along with library functions to constitute an executable 
Task that runs under the control of the Real-Time Monitor (RSX-15) . A 
resultant Task is defined by its name (Task name) , default run priority, 
core partition and common block requirements, and resident code. Once 
a Task has been built it may be incorporated into the real-time operat- 
ing system under control of the Real-Time Monitor from DECtape or 
paper tape. 

5.2 TASK BUILDER DESCRIPTION 

The following description of TKB asssumes the reader has a thorough 
understanding of the ADVANCED Software System CHAIN* program since only 



*TKB and CHAIN have identical Input/Output Device Assignments and load- 
ing procedures. (See CHAIN & EXECUTE Manual DEC-15-YW2A-DN2) 
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minor differences exist between the two. Only areas which are not part 

of the CHAIN program will be amplified in this section. Answers to all 

questions, as for the CHAIN program, must end with an ALT MODE. 

LIST OPTIONS 

SZ to output size in load maps, GM to output Global Symbol & 
File names instead of program names in load maps, NM for no 
load map, and PAR & PAL for pause after outputting resident 
code and pause after outputting each Link. 

NAME TASK 

Identical to NAME XCT FILE in CHAIN. 

SPECIFY DEFAULT PRIORITY 

This is the default priority of the Task which will be assumed 
at INSTALL time. Default priority is optional and can be any 
number from 1 (highest priority) to 512 (lowest priority) . 

DESCRIBE PARTITION 

This is the name of the core partition in which the Task is 
to be executed. The form of the partition description is: 
NAME (BASE ADDRESS, SIZE) . The NAME is the name of a Partition 
defined in the RSX System, BASE is the octal start address of 
the partition, and SIZE is the size of the partition which 
the Task is to occupy. 

DESCRIBE SYSTEM COMMON BLOCKS 

These are the names of the Common Blocks which are referenced 
by the Task but are common to all Tasks in the RSX System. 
The form of the Common Blocks is: NAME (BASE ADDRESS, SIZE) . 
NAME is the name of the Common Block defined in the RSX System, 
BASE is the octal start address of the Common Block, and SIZE 
is the maximum size of the Common Block in which data is to 
be placed. Additional Common Block descriptions (maximum of 
four) may be specified by separating the descriptions with 
commas. Blank and Named Common declared in FORTRAN programs 
will be included in the Task's partition block if not speci- 
fied in a DESCRIBE SYSTEM COMMON BLOCKS description. Blank 
Common assumes the default name of .XX. 

DEFINE RESIDENT CODE 

Identical to CHAIN program. 
DESCRIBE LINKS & STRUCTURE 

Identical to CHAIN program. 
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5.3 EXAMPLE USING THE TASK BUILDER 

tc 

XMS5-15 V5A 

$A DKl -4/DTl -6 

$TK3 

TASK BUILDER VIA 

LIST OPTIONS 

>SZ 

HAME TASK 

>SU1 

SPECIFY DEFAULT PRIORITY 

>HVJ 

DESCRIBE PARTITION 

>P40. 0(40000, 15000) 

DESCRIBE SYSTEM COMMON BLOCKS 

>FLAG( 36200, 600) 

DEFIME RESIDENT CODE 

>r"lAIN,Fl,F2,['lAC 

DESCRIBE LINKS & STRUCTURE 



r^AiN 


40020- 


-40047 


00030 


Fl 


40050- 


-40117 


00050 


F2 


40120- 


-40255 


00136 


MAC 


40256- 


-40303 


00026 


WAFF. I 


40304- 


-40316 


00013 


DSGF.2 


40317- 


■40360 


00042 


EXIF.l 


40361- 


-40363 


00003 


.DA 


40364- 


-40432 


00047 


.DAA 


40433- 


•40501 


00047 


BCDIO 


40502- 


•43537 


3535€ 


.SS 


43540- 


•43617 


00060 


ST0.3 


43620- 


•4363! 


00012 


FI0.3 


43632- 


•44311 


00460 


0TS.5 


44312- 


•44440 


00127 


.SP.5 


44441- 


•44560 


00120 


IMTEAE 


44561- 


■44674 


00114 


RELEAE 


44675- 


•45736 


01042 


.CB 


45737- 


•45756 


000 20 


BLANK 1 


COMMON 






.XX 


45757- 


•46266 


00310 



CORii RSQ'D 

40000-46266 06267 



KM '5-15 V5A 

S 
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tc 

KM9-15 V5A 

$A DKI -4/DTl -S 

$TK8 

TASK BUILDER VIA 

LIST OPTIONS 

>SZ 

NAME TASK 
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CHAPTER SIX 
SYSTEM CONFIGURATOR 

5.1 INTRODUCTION 

The RSX-15 System is supplied on DECtape (RSX COLD START MASTER TAPE) 
with each PDP-15/35 computer as a very generalized software package. 
The Master Tape of the system consists of the RSX Executive, Multi- 
Teletype Handler, Disk Handler, Monitor Console Routine (MCR) Func- 
tion Tasks, and one running Task called the SYSTEM CONFIGURATOR. The 
SYSTEM CONFIGURATOR enables the user to tailor his software to fit his 
requirements. 

The SYSTEM CONFIGURATOR allows the user to specify core size, disk 
size, number of Teletypes, clock frequency. Partition descriptions, 
system COMJION Block descriptions, and a description of peripheral I/O 
units. Partitions and COMMON Blocks may be defined anywhere between 
the top of the Executive (over the SYSTEM CONFIGURATOR) thru the top 
of core (as long as they do not overlap each other) . Partition Blocks 
and the "Pool of Empty Nodes" are constructed in core above the 8K 
that has not been defined as a part of a Partition or COMMON Block. 
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After the Pool and Partition Blocks have been constructed, all Tasks 
recorded on DT-^ that can be installed in the newly configured system, 
are installed. After installation from DT-0 , the number of empty 
nodes in the Pool is typed out, and the system is left running. 

6.2 INSTALLING THE RSX SYSTEM 

When the user receives the RSX COLD START MASTER TAPE he should per- 
form the following steps to configure the RSX Software to best fit his 
needs and requirements : 

1) Mount the RSX COLD START MASTER TAPE onto DECtape unit zero 

(WRITE LOCK) . 

2) Read into location 00000 the RSX DECTAPE BOOTSTRAP from the 
High Speed Paper Tape Reader. This will cause the Cold Start 
image to be read in from the Master Tape and the SYSTEM 
CONFIGURATOR started. 

3) Answer all questions asked by the SYSTEM CONFIGURATOR (See 
section 6.3). 

4) When the system configuration has completed* and the message 
"MCR>" is printed on the console Teletype, the user should 
install his own Tasks into the system and issue the "SAVE" 
MCR Function command to save an image of the new system on 
the disk. 

5) To make a backup copy of the system, mount scratch tapes on 
DECtape units one and two (one at a time if only a limited 
number of DECtapes are available) and read into location 00000 
the "DISK TO DECTAPE" from the High Speed Paper Tape Reader to 
copy an image of the disk(s) onto the DECtapes. This backup 
system can be restored by reading in "DECTAPE TO DISK" from 
the High Speed Paper Tape Reader. NOTE: Two DECtapes are 
required for each disk unit saved. Writing begins on DECtape 
unit one for the first half of the first disk and automatical- 
ly transfers to DECtape unit two when unit one is filled. 
This process is automatically repeated (from DECtape one to 
two) until all disks have been saved. (Rewinding and unload- 
ing DECtapes between save/restore operations is performed by 
the save and restore programs.) A similar procedure is used 
to restore the system from DECtape to disk. The tapes may be 
restored in any order with transfer beginning from DECtape 
unit one and continuing with DECtape unit two. Each DECtape 
will contain 131,072,- disk words followed by a descriptor 
block. '^ 



* The SYSTEM CONFIGURATOR is a one-time Task that automatically removes 
itself once the system has been configured. 
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5) Read into location 00000 the RSX DISK (WARM START) BOOTSTRAP 
from the High Speed Paper Tape Reader. This will cause the 
restored RSX System to be brought in from the disk and the 
message "MCR>" to be printed on the console Teletype. The 
System is now ready to accept commands from the user. 



6.3 STEP BY STEP SYSTEM CONFIGURATION PROCEDURE 

QUEST ION ANSWER 
SPECIFY CORE SIZE> 

16K, 2j2fK, 24K, 28K, or 32K (Size of user's core memory) 

SPECIFY NUMBER OF DISK UNITS> 

1 to 8 (Number of physical disk units ) 
SPECIFY NUMBER OF TTY'S> 

1 to 17 (Number of Teletypes connected to the system. ) 
SPECIFY NUMBER OF CLOCK TICKS PER SECOND> 

1 - 1000 (This is the line frequency used to set the Real-Time 
Clock frequency in the RSX Executive, and will normally be 50 
or 60.) 

DEFINE PARTITIONS "NAME (BASE, SIZE) " 

These are the names (NAME) of all partitions in the System along 
with their base addresses (BASE) and sizes (SIZE) . A line with 
only a terminator (carriage return or ALTMODE) will terminate the 
response. 

DEFINE SYSTEM COMMON BLOCKS "NAME (BASE, SIZE) " 

These are the names of COMMONS to be used for inter-task communica- 
tion or extra-task data storage. Core is permanently allocated and 
these COMMONS are always available. The Names, Base Addresses, and 
Sizes are specified. A line with only a terminator (carriage re- 
turn or ALTMODE) terminates the response. 

SPECIFY DEVICE NAMES AND UNIT NUMBERS (ONE PER LINE) 

List only devices which will be used by the user. Device names 
are two characters in length followed by a unit number. (The Tele- 
types and Disk are specified in the system.) The following are 
names of devices for which I/O Handler Tasks are supplied witw t».e 
system: 

LP = Line Printer 

DTn = DEC tape {n=0 to 7) 

PR = High Speed Paper Tape Reader 

PP = High Speed Paper Tape Punch 
A line with only a terminator (carriage return or ALTMODE) termi- 
nates the response. 
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INSTALLATION OF TASKS FROM DTJJ 

This process requires no response from the user. All Tasks on DTjZf 
that can be installed, are installed in the System at the default 
priority defined at Task Building time. When all Tasks have been 
installed, the CONFIGURATOR continues with: 

nnnnn NODES IN POOL 

This is the number (nnnnn) of empty nodes (in decimal) in the POOL 
available for queueing and scheduling. The CONFIGURATOR continues 
with : 

SYSTEM IS RUNNING 

This indicates to the user that the system is running and the 
Resident MCR responds by typing "MCR>". The System is now ready 
to accept user's commands from the console Teletype. 
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6.4 EXAMPLE OF A SYSTEM CONFIGURATION PROCEDURE 



RSX SYSTEM CONFIGURATION 

SPECIFY CORE SIZE >24K 

SPECIFY NUMBER OF DISK UNITS >1 

SPECIFY NUMBER OF TTY'S >4 

SPECIFY NUMBER OF CLOCK TICKS PER SECOND >S0 

DEFINE PARTITIONS "NAME(BASE,SIZE) " 
>MCRCI0000,1S00) 
>I0. 1(11630,3000) 
>I0. 2(35200, 1900) 
>PI4. 6(14600, 3200) 
>P21. 0(21000, 5500) 
>P26. 5(26500, 6500) 
>P40. 0(40000, 15000) 
> 

DEFINE SYSTEM COMMON BLOCKS "NAME(BASE,SIZE) " 

>.XX(20000,700) 

> FL A G( 36 20 0,600) 

> 
SPECIFY DEVICE NAMES & UNIT NUMBERS (ONE PER LINE) 

>DT0 

>DT1 

>DT2 

>DT3 

>PR 

>PP 

> 

INSTALLATION OF TASKS FROM DT-0 
00171 NODES IN POOL 
SYSTEM IS RUNNING 

i^;CR>SAVE 
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6.5 DESCRIPTION OF SYSTEM CONFIGURATOR ERROR MESSAGES 

tf + WOULD OVERFLOW ADJACENT AREAS — RETYPE 

A Partition and/or COMMON Block has overflowed in an adjacent 
area. The user roust redefine the COMMON or Partition. 

+++ SYNTAX ERR AT "X" — RETYPE 

The illegal character "X" was found in the command string, retype 
the line. 

+++ INVALID SIZE ~ RETYPE 

Illegal core size. Must be either 16K, 20K, 24K, 28K, or 32K. 

t+f INVALID NUMBER — RETYPE 

Illegal number of disk units. Teletype units, or clock frequency 
setting. 

++f NAME ALREADY USED — RETYPE 

The name of the Partition or COMMON Block is already defined in 
the system. Partitions and COMMON Blocks may not have the same 
name. 

+++ DEVICE NAME/UNIT ERR — RETYPE 

Device name and unit already defined. 

*** DISK READ ERR 

A disk read error has occurred. The system will halt and wait 
for the user to manually depress the continue switch to retry the 
disk read. 

*** DISK WRITE ERR 

A disk write error has occurred. The system will halt and wait 
for the user to manually depress the continue switch to retry the 
disk write. 

*** RE-ENTRANT ECO PACKAGE NEEDED 

The user's machine does not have the RE-ENTRANT ECO PACKAGE 
required to run RSX. Contact your local field service office. 

*** INSUFFICIENT FREE CORE — RE-STRUCTURE 

Insufficient free core for storage of all Partition Blocks or out 
of nodes in the Pool. 

TASK "XXXXXX" NOT INSTALLED, TASK ALREADY IN SYSTEM 

The Task XXXXXX is already installed in the system. 

TASK "XXXXXX" NOT INSTALLED, PARTITION NOT IN SYSTEM 

The Task XXXXXX was built for a partition which is not defined in 
the system. 
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TASK "XXXXXX" NOT INSTALLED, TASK WOULD OVERFLOW PARTITION 

The Task XXXXXX is larger than the partition defined for it in the 
system. 

TASK "XXXXXX" NOT INSTALLED, OUT OF DISK STORAGE 

The Task XXXXXX is larger than the amount of available Disk stor- 
age required to install the Task. 

TASK "XXXXXX" NOT INSTALLED, INPUT CHECKSUM ERR 

An input checksum error occurred while installing Task XXXXXX 
from DEC tape. 

TASK "XXXXXX" NOT INSTALLED, INPUT PARITY ERROR 

An input parity error occurred while installing Task XXXXXX from 
DEC tape. 

TASK "XXXXXX" NOT INSTALLED, SYSTEM COMMON BLOCK ERR 

COMMON Block not defined in system or COMMON Block BASE and/or 
SIZE specified incorrectly (to the Task Builder) . 

TASK "XXXXXX" NOT INSTALLED, READ ERROR 

An illegal DECtape block number was found or a DECtape 
error exists. 

TASK "XXXXXX" NOT INSTALLED, NO DEFAULT PRIORITY 

The Task XXXXXX was not given a default priority at Task Building 
time. The INSTALL MCR Function can be used to install the Task 
once System Configuration has completed. 
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CHAPTER SEVEN 
SYSTEM ORGANIZATION 

7.1 INTRODUCTION 

The RSX System is organized into several units consisting of: The 
Executive, Partitions, Partition Blocks, System COMMON Blocks, several 
linked lists, and a pool of empty list nodes. The Executive, or heart 
of the system, lies entirely in the lower 4K memory bank and consists 
of the Resident MCR Task, Teletype and Disk I/O Handler Tasks, and 
assorted routines to properly carry out the functions of a real-time 
operating system. The remaining area of core memory is available for 
Partitions, Partition Blocks, System COMMON Blocks, and the Pool of 
Empty Nodes. The following sections describe the system in more detail, 

7.2 RSX BOOTSTRAPS 

The RSX DECTAPE BOOTSTRAP is read in at location 00000 and starts a 
DECtape to core transfer from tdpe block zero into core location 30. 
The size of the image loaded is the same as the image that was recorded 
and is determined by the word count and current address registers 30 & 
31. This bootstrap is normally used to initiate a COLD START, but can 
also be used to initiate a WARM START of a system that does not use the 
disk, i.e., to load an image of a system where all Tasks have been 
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fixed-in-core. viz. , an emergency system in case of disk failure. 

The RSX DISK (WARM START) BOOTSTRAP is a program used to restore a 

core image of the system (recorded by a SAVE MCR Function) , from 
disk unit zero into core memory. 

The DISK bootstrap is read into location !i0^00, clears the disk con- 
troller, and begins transfer starting from the beginning of disk zero 
and core location fS0030. Transfer continues until the entire core 
memory has been restored. When the system has been successfully re- 
stored, control is transferred to the address specified by Rl (abso- 
lute location 1^1 in the System Communications table) causing the 
8 

system to be started. 

7.3 RSX MEfiORY fW USAGE 



Partitions required 
to install the 
pre-built MCR & 
I/O Handler Task 
supplied on the 
Cold Start Image 
Tape. Normally, 
the I/O Handler 
Tasks are rebuilt 
to run in parti- 
tions that satisfy 
requirements of 
particular 
applications. 
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> Partition 
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Nodes . 



/ 8K 

\ Partitions and 
COMMON Blocks*, 



^ 4K 



Figure 7.1 



* Unspecified core space between Common Blocks and Partitions which 
exist between the RSX Executive and the 8K memory boundary is not used 
by the system. 
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7.4 SYSTEM DEQUES 

The RSX System uses linked lists, rather than tables, to maintain 
system information. These lists are linked together as Double Ended 
Queues called deques- Each deque consists of a listhead and list 
elements, or nodes, circularly linked by both forward and backward 
pointers. The first word of a node or listhead is a forward pointer 
containing the address of the next node (or the listhead) looking 
forward. The second word of a node or listhead is a backward pointer 
containing an address of the previous node (or the listhead) looking 
backward. The listhead consists of only the two pointers. All nodes 
in a deque consist of the two pointers followed by eight words of data. 
Some of the major deques used in the RSX System are the Active Task 
List (ATL) , the System Task List (STL), the Clock Queue, and the 
Physical Device List (PDVL) . 
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Figure 7.2 A three node deque 




Figure 7.3 An empty deque 
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7A,l POOL 

During System Configuration, core which has not been specified by the 
user for other purposes (viz., Partitions and COMMON Blocks), is 
divided into ten-word blocks (empty ten-word nodes) and linked to- 
gether forming a deque called "The Pool of Empty Nodes" or "Pool". 
When a node is needed to expand a list, it is taken ("Taken" implies 
changing the node pointers, not moving ten words of data) from the 
Pool. When a node is no longer needed, it is returned to the Pool. 



7A:l THE SYSTEM TASK LIST (STL) 

The System Task List (STL) is a directory of Tasks in the system. 

The STL is a deque consisting of one node for each Task currently in 

the system. An STL node has the following format: 

Word — Forward pointer 

Word 1 — Backward pointer 

Word 2 — Task name (first half in .SIXBT) 

Word 3 — Task name (second half in .SIXBT) 

Word 4 — Flags and Default priority 

Word 5 — Partition Block Address 

Word 6 — Disk address of Task image 

Word 7 — Size of resident image 

Word 10 — Disk storage allocated 

Word 11— Task entry point 

Word 4, the Flags and Default priority, has the following bit designa- 
tions: 

Bit — set when the Task is active 

Bit 1 — Unused 

Bit 2 — set when the Task is disabled 

Bit 3 — set when the Task is "Fixed in Core" 

Bit 4 — Unused 

Bit 5 — Unused 

Bits 6 - 17 ~ Task's default priority 

Word 6, the Disk address, contains the disk unit number in bits 15-17. 

Nodes are added to the STL whenever a Task is INSTALLed into the system, 
and deleted from the STL when a Task is REMOVEd from the system. 
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7A.3 THE ACTIVE TASK LIST (ATL) 

The Active Task List (ATL) is a priority ordered list of Active Tasks. 

The ATL is a deque consisting of one node for each Active Task in the 

system. An ATL node has the following format: 

Word — Forward pointer 

Word 1 — Backward pointer 

Word 2 — Task name (first half .SIXBT) 

Word 3 — Task name (second half .SIXBT) 

Word 4 — Task run priority 

Word 5 — Partition block address 

Word 6 — STL node address 

Word 7 — Task status indicator 

Word 10 — Start or resumption address 

Word 11 — Event variable address 

The ATL is ordered by the priority of the Active Tasks and is used to 

drive the system. The order in which Tasks are considered is determined 

by scanning the list, and the action to be taken is determined by 

examining the Task status word. There are six levels of status, each 

of which is described below: 

Status 1: Task image is on the disk. If its partition is available, 
flag partition unavailable and proceed to status two; 
otherwise, service next Task in ATL. 

Status 2: Task image is on the disk and the partition is available for 
its use. Queue disk read request with Event Variable in ATL 
(Word 11) and proceed to status three. 

Status 3: Waiting for an Event Variable. If the Event Variable, whose 
address is in the ATL, is non-zero, proceed to status four; 
otherwise service next Task in the ATL. 

Status 4: Task is ready to be started or resumed. In order that its 

environment will be saved if it is interrupted by the Execu- 
tive, set status five, and start or continue Task execution. 
(Status four may be set by the WAIT or RESUME Directives.) 

Status 5: Task has been interrupted by the Executive (environment saved 
in partition block) . Restore environment and return control 
to Task. 

Status 6: Task has been suspended. (Status six is set only by the 
SUSPEND Directive.) 



7AA THE CLOCK QUEUE 

The Clock Queue is a deque consisting of one node for each item to be 
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done at some time in the future. These items are: scheduling of Tasks 

(SCHEDULE, RUN, and SYNC Directives), rescheduling of Tasks (Clock 

interrupt service routine), and setting of Event Variables after 

elapsed time periods (MARK Directive) . The nodes are linked in the 

order in which they come due, and have the following format: 

Word — Forward Pointer 

Word 1 — Backward pointer 

Word 2 — Type indicator {TS,MT) 

Word 3 — Unused 

Word 4 — Run priority (TS) or Event Variable address (MT) 

Word 5 — STL node address (TS) or zero (MT) 

Word 6 — Schedule interval seconds (TS,MT) 

Word 7 — Schedule interval ticks (TS,MT) 

Word 10 — Reschedule interval seconds (TS) 

Word 11 — Reschedule interval ticks (TS) 

TS — Task Scheduling usage 
MT — Mark Time usage 

Word 2, the Type indicator, is set as follows: 

— Task scheduling with no rescheduling 

1 — Task scheduling with periodic rescheduling 

5 — Mark time request 

6 — Null node (result of cancellation) 

The schedule interval in all nodes, except the first node, is relative 
to the previous node. The schedule interval in the first node is 
relative to "now" and is decremented and examined at each clock tick. 
Two words are used to record the schedule interval: "schedule ticks" 
and "schedule seconds". The schedule ticks is only zero when a node 
is to come due at the same time as the previous node and is never 
greater than the number of ticks per second. When an interval of more 
than one second is represented, the schedule seconds indicates the 
number of additional whole seconds. The "reschedule ticks" and 
"reschedule seconds" eure the schedule interval reset values when 
periodic Task rescheduling has been requested. 

7.i|.5 THE PARTITION BLOCKS DESCRIPTION LIST (PBDL) 

Partition Blocks serve three functions: (1) They contain partition 
description information to assure that a Task being installed into the 
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system has been built for an existent partition; (2) they provide core 
for an Event Variable and disk GET (DSKGET) control table necessary to 
load Tasks into partitions; and (3) they provide for saving a Task's 
environment when it is interrupted by the Executive. The Partition 
Blocks are generated by the System Configurator and are linked together 
into a deque called the Partition Blocks Description List with abnormal 
nodes having the following format: 



Word 
Word 
Word 
Word 
Word 
Word 
Word 
Word 




1 
2 
3 
4 
5 
8 
7 



Word 10 
Word 11 
Word 12 
Word 13 
Word 14 
Word 15 
Word 16 
Word 17 
Word 20 
Word 21 
Word 22 
Word 23 
Word 24 
Word 25 
Word 26 
Word 27 
Word 30 
Word 31 
Word 32 
Word 33 



— Forward pointer 

— Backward pointer 

— Partition neune (first half .SIXBT) 
-- Partition name (second half .SIXBT) 

— Partition base (address) 

— Partition size 

=- Flags word (bit indicates partition is occupied) 
-- Register save routine entry point (operand address for 
wd. 12) 

— Interrupt connect location (JMS here upon interrupt) 

— DBA instruction 

-- JMS* .-3 instruction (transfer to save routine) 
-- AC buffer 



— XR buffer 
-- LR buffer 

— MQ buffer 

— SC buffer 

— Rl buffer 

— R2 buffer 
-- R3 buffer 

— R4 buffer 

— R5 buffer 
-- R6 buffer 

— XIO buffer 
-- Xll buffer 

— X12 buffer 

— X13 buffer 
-- L20 buffer 
■- SKP 



(Words 15 thru 21 are used by 
the Executive during status two 
and three to store the disk read 
Event Variable and Control 
Table) 

(Rl thru R6 are pseudo registers 
used by re-entrant system 
routines ) 

(XlO thru X13 are autoincrement 
registers 10 thru 13) 



(CAL return parameters) 
SKP is an indicator to the 
register save routine to trans- 
fer control to the Executive 
(NOP indicates transfer to an 
interrupt service routine) . 



7.i}.6 THE PHYSICAL DEVICE LIST (PDVL) 

When a logical I/O unit is assigned to a physical unit, the address 
of a node describing the device and unit is set in a logical unit table 
entry corresponding to the Logical Unit Number (LUN) . These nodes are 
constructed by the System Configurator and linked together into a deque 
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called the Physical Device List. Each PDVL node has the following 

format : 

Word — Forward pointer 

Word 1 — Backward pointer 

Word 2 — Device name {first half .SIXBT) 

Word 3 — Device name (second half /always zero) 

Word 4 — Device Attach flag 

Word 5 — Unit number 

Word 6 — Device request queue (deque listhead) forward pointer 

Word 7 — Device request queue (deque listhead) backward pointer 

Word 10 — Trigger Event Variable address 

Word 11 — Assign inhibit flag 



7AJ THE SYSTEM COMMON BLOCK DEFINITION LIST (SCDL) 

The System COMMON Block Definition List (SCDL) is a deque built by the 

System Configurator consisting of a description of each COMMON Block 

in the System. An SCDL node has the following format: 

Word — Forward pointer 

Word 1 — Backward pointer 

Word 2 — COMMON Block name (first half .SIXBT) 

Word 3 — COMMON Block name (second half .SIXBT) 

Word 4 — Unused 

Word 5 ~ Base of COMMON Block (address) 

Word 6 — Size of COMMON Block 

Word 7 — Unused 

Word 10 — Unused 

Word 11 — Unused 



7.5 INPUT/OUTPUT OPERATIONS 

Input/Output operations in the RSX System are device independent, with 
I/O requests being made to Logical Device Units rather than Physical 
Device Units. Logical Units are eguivalenced to Physical Device Units 
via a Logical Unit Table (LUT) . The LUT is a block of contiguous core 
with a one word entry, or slot, for each LUN. LUN slots are designated 
sequentially from one and will contain a zero if unassigned (assigned 
to NONE). The LUT is maintained by the REASSIGN MCR Function. 

Physical Device Units are represented by nodes in a deque called the 
Physical Device List (PDVL) . When a LUN is assigned to a Physical 
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Device Unit, the corresponding LUT slot contains the address of the 
appropriate Physical Device List node. Corresponding to the LUT is an 
Attach-Flag-Table (AFT) with a two word entry for each LUT slot. 
Whenever a LUN is attached to a Task , the Task name is set in the 
corresponding AFT slot. Whenever a LUN and Device Unit are both 
attached to a Task, the Device attach flag in the PDVL points to the 
appropriate AFT slot. 

7.5.1 I/O HANDLER TASK INITIALIZATION 

All I/O Handlers are RSX Tasks and are called I/O Handler Tasks 
(lOHT's). They differ from most other Tasks in that they contain an 
interrupt service routine and that a naming convention exists.* 

When a LUN is assigned to a Physical Unit, the appropriate I/O Handler 
Task is REQUESTed (by the REASSIGN MCR Function) . The Handler Task 
then initializes itself and instructs the system (using the WAITFOR 
Directive) to suspend its execution until its Trigger Event Variable 
is set. Handler Task initialization consists of CONNECTing to an 
interrupt line and setting the address of the Task's Trigger Event 
Variable in the corresponding Physical Device List node(s). 

A Handler Task normally services all Units of a Device- 

7.5.2 I/O REQUESTS 

I/O requests are made using the QUEUE I/O Directive. This Directive 
expects to find a PDVL node address in the LUT slot indicated by the 
LUN, and a Trigger Event Variable address in the PDVL node. If the 
LUT slot contains a zero, the request is rejected because the LUN has 
not been assigned to a Physical Unit. If the Trigger Event Variable 
address is zero, the request is rejected because the H2uidler Task has 
not yet been initialized. If the LUT slot and Trigger Event VarieOsle 



* See section 8.5 
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address have been set, a request node is formed and inserted into a 
request queue, and the Handler Task is "triggered" by setting the 
Trigger Event VarieUsle and declaring a Significant Event. If a 
Handler Task is triggered while it is servicing a request, the trigger 
is ignored; however, if a Handler Task is idle, the trigger will bring 
it back into service. 

There are separate I/O request queues for each Physical Device Unit. 
These queues are deques with their listheads in the PDVL nodes for the 
physical units. Requests are normally serviced in order of priority 
by simply picking up the front node from the request queue. I/O 
requests are processed at API level 7 and are de-queued by priority of 
the requestor (software priority 1-512) with the highest priority 
request at the front of the deque. Requests of equal priority are 
inserted in the order that the requests were made. 

If a Physical Device Unit is ATTACHed, only requests from the Task 
that issued the ATTACH will be serviced, however, I/O requests from 
all Tasks are queued. When the DETACH request is serviced, pending 
I/O requests from other Tasks in the queue will then be serviced. 

The QUEUE I/O Directive allows an I/O requestor to specify an Event 

Variable to be set to indicate the status of a request. If a request 

cannot be queued, the requestor's Event Variable is set to one of the 

following negative values: 

-101 — Illegal (out of range) LUN 
-lJ2f2 — LUN not assigned to a physical unit 
-1JJ3 — Handler not resident and initialized 
-777 — Request node not available (pool empty) 

If a request is queued, the requestor's Event Variable is zeroed to 

indicate that the request is pending and the Handler Task will set it 

non-zero. If a Handler Task cannot successfully complete a request, 

it will set the requestor's Event Variable to a negative value. (See 

Appendix D for a complete list of returned Event Variables. 
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When an I/O request is successfully completed, the requestor's Event 
Variable is set positive, normally to one (+1). 

7.5.3 I/O FUNCTIONS 

The following is a description of CAL Parameter Block operands for 
the QUEUE I/O Directive. The FUNCTION CODE WORD contains the CAL 
Function Code for the QUEUE I/O Directive (00) in bits 12-17 and the 
I/O Function code in bits 3-11. An Event Variable address of zero 
implies "no Event Variable specified". ALLOCATE, DEALLOCATE, GET, and 
PUT are device dependent functions, and the address of a table of con- 
trol information is a peurt of the request, i.e., the Control Table is 
not queued. 

ALLOCATE (4 words) 

FUNCTION CODE WORD (1500) 
EVENT VARIABLE ADDRESS 
LOGICAL UNIT NUMBER 
CONTROL TABLE ADDRESS 

DEALLOCATE (4 words) 

FUNCTION CODE WORD (1600) 
EVENT VARIABLE ADDRESS 
LOGICAL UNIT NUMBER 
CONTROL TABLE ADDRESS 

ATTACH (3 words) 

FUNCTION CODE WORD (2400) 
EVENT VARIABLE ADDRESS 
LOGICAL UNIT NUMBER 

DETACH (3 words) 

FUNCTION CODE WORD (2500) 
EVENT VARIABLE ADDRESS 
LOGICAL UNIT NUMBER 

READ (6 words) 

FUNCTION CODE WORD (2600) 

EVENT VARIABLE ADDRESS 

LOGICAL UNIT NUMBER 

DATA MODE INDICATOR 

CORE BUFFER ADDRESS 

BUFFER SIZE (max words transferred) 

WRITE (5 words) 

FUNCTION CODE WORD (2700) 
EVENT VARIABLE ADDRESS 
LOGICAL UNIT NUMBER 
DATA MODE INDICATOR 
CORE BUFFER ADDRESS 
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GET (4 words) 

FUNCTION CODE WORD (3000) 
EVENT VARIABLE ADDRESS 
LOGICAL UNIT NUMBER 
CONTROL TABLE ADDRESS 

PUT (4 words) 

FUNCTION CODE WORD (3100) 
EVENT VARIABLE ADDRESS 
LOGICAL UNIT NUMBER 
CONTROL TABLE ADDRESS 

SEEK (6 words) 

FUNCTION CODE WORD (3200) 
EVENT VARIABLE ADDRESS 
LOGICAL UNIT NUMBER 
FILE NAME (first half) 
FILE NAME (second half) 
FILE NAME EXTENSION 

ENTER (6 words) 

FUNCTION CODE WORD (3300) 
EVENT VARIABLE ADDRESS 
LOGICAL UNIT NUMBER 
FILE NAME (first half) 
FILE NAME (second half) 
FILE NAME EXTENSION 

CLOSE (3 words) 

FUNCTION CODE WORD (3400) 
EVENT VARIABLE ADDRESS 
LOGICAL UNIT NUMBER 

DELETE (6 words) 

FUNCTION CODE WORD (3500) 
EVENT VARIABLE ADDRESS 
LOGICAL UNIT NUMBER 
FILE NAME (first half) 
FILE NAME (second half) 
FILE NAME EXTENSION 

HINF (3 words) 

FUNCTION CODE WORD (3600) 
EVENT VARIABLE ADDRESS 
LOGICAL UNIT NUMBER 

The following Control Table formats are expected by the Disk Driver: 

ALLOCATE (3 words) 

REQUIRED STORAGE (IN WORDS) 
DISK UNIT* 
TRACK & HEAD* 



Set by the Disk I/O Handler, not the requestor. 
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DEALLOCATE (3 words) 

STORAGE ALLOCATED 
DISK UNIT 
TRACK & HEAD 

GET (4 words) 
DISK UNIT 
TRACK & HEAD 
CORE ADDRESS 
WORD COUNT 

PUT (4 words) 
DISK UNIT 
TRACK & HEAD 
CORE ADDRESS 
WORD COUNT 



ISA HANDLER TASK EXIT 

When there are no Logical Unit N\imbers assigned to a physical device, 
the REASSIGN MCR Function sets the "assign inhibit flag" and clears 
the Trigger Event Variable address in the Physical Device List node 
for each unit of the device and inserts an EXIT request in the I/O 
queue for one of the device's units. The Handler Task services the 
EXIT request by: 1) DISCONNECTing from an interrupt line, 2) clearing 
the assign inhibit flag, and 3) EXITing. 

7.5,5 DISK STRUCTURE 

A disk unit (platter) in the RSX System contains a total of 262,144 
decimal words which is divided into 2048 decimal blocks of 128 decimal 
words each for purposes of storage allocation. The disk is word ad- 
dressable for data transfer purposes. Recorded on each disk platter 
is a bit map that indicates which areas of the disk are free (to be 
ALLOCATBd) and those which are reserved (already ALLOCATEd) . These 
maps are initialized (cleared) by the System Configurator indicating 
that all blocks* are free. Bit maps consist of 128 decimal words 



* Excluding one bit map block per platter and save area on platter zero. 
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(1 disk block) beginning at location 7776J(JJ_ on each platter. Each 
word in the bit map represents 16 decimal consecutive blocks. Bits 
16 & 17 of the PDP-15 word are unused. A ^-bit indicates a block is 
free and a 1-bit indicates it is occupied. 

Since there may exist up to 8 disk platters, it is possible for an 
ALLOCATE request to require 9 disk transfers (approximately 30J? milli- 
seconds) . To prevent holding off high priority disk requests for this 
length of time, the Disk handler consists of two Tasks: "DSK", the 
Disk Driver, and "DSA", a lower priority Task that handles Disk 
ALLOCATE/DEALLOCATE requests. Whenever "DSK" encounters an ALLOCATE 
or DEALLOCATE request in its I/O request queue, it simply moves the 
request node from its own queue to another queue belonging to "DSA" . 
Then it sets "DSA's" trigger event variable and declares a significant 
event so that "DSA" will run ("DSA" runs at a priority level lower than 
"DSK"). 



7.5.6 I/O DATA MODES 

The following I/O data modes are supported in the RSX System: 

lOPS BINARY {mode 0) 

IMAGE BINARY (mode 1) 

lOPS ASCII (mode 2) 

IMAGE ASCII (mode 3) 

The data modes, including line buffer construction, have identical 

meanings to those used in the ADVANCED Software System (see PDP-15 

ADVANCED Software System Monitors Manual section 2.2 and 2.3). 

I/O Handler Tasks provided by DEC are listed below along with the data 

modes each is capable of handling: 

DT — All 
DK — None* 



Data modes do not apply to the GET and Put functions. 
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LP ~ lOPS ASCII & IMAGE ASCII 

XT ~ lOPS ASCII & IMAGE ASCII 

PP — All 

PR — All 



7.5.7 INTERRUPT PROCESSING 

Interrupt processing under the RSX System consists of hardware inter- 
rupts having various levels of priorities. The hardware interrupts 
normally suspend the execution of other functions in the System in- 
cluding the Executive; however, the Executive delays the servicing of 
hardware interrupts while it is completing internal operations which 
cannot be interrupted. These operations are always short in duration 
and involve the updating of the various lists of system information 
maintained by the Executive. This delay is never greater than 30 usees. 

Real-Time programs connect themselves to hardware interrupt lines with 
the use of System Directives; and when hardware interrupts occur on 
those lines, control is transferred by the hardware (API) directly to 
the interrupt service routines. Once an interrupt service routine has 
been entered, it can either save its active registers or use the 
Executive's Register Save and Restore routines to preseirve the contents 
of the active system registers. The user, however, might or might not 
decide to save the registers of an interrupted Task depending on timing 
constraints. Some cases may only require the saving of the Accumu- 
lator (AC) which would be done by the interrupt service routine itself. 
The Executive ' s Save and Restore routines , however , save and restore 
several system registers including the Accumulator, Link, MQ, first 
four Autoincrement, Limit, and Index Registers. The decision 
whether or not to use the Executive ' s Save and Restore routines depends 
on two considerations. First, can the interrupt service routine 
tolerate delays incurred by using these routines (each operation re- 
quires about 70 usees). Second, how many of the system's active 
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registers are used by the interrupt service routine? 

To illustrate the different methods the user can use for saving and 

restoring system registers, two excunples are given. Ex2UDple one 

illustrates an interrupt service routine which only requires saving 

the Accumulator, and excunple two illustrates the use of the Executive's 

Save and Restore routines when several registers are required in the 

interrupt service routine. 

Excunple 1; Assume the interrupt service routine requires only the 
Accumulator and does not desire to use the Executive's 
routines because of timing constraints. The interrupt 
service routine could be structured as follows: 



SERDEV /ENTRY POINT TO ROUTINE 

DBA /ENTER PAGE ADDRESSING MODE 

DAC SAVEAC /SAVE ACCUMULATOR 

/REAL-TIME PROGRAM EXECUTES AT HARDWARE 
/ PRIORITY LEVEL. 

• • 

LAC SAVEAC /RESTORE ACCUMULATOR 

DBR /DEBREAK FROM HARDWARE LEVEL 

JMP« SERDEV /RETURN TO INTERRUPTED TASK 

SAVEAC /TEMPORARY STORAGE FOR ACCUMULATOR 



Example 2: Assume the interrupt service routine requires several 
system registers and desires the use of the Executive'! 
Save and Restore routines. 



INTENTRY SERDEV 



/ENTRY POINT TO ROUTINE. INTENTRY IS A 

/ SYSTEM MACRO TO CALL THE EXECUTIVE'S 

/ SAVE ROUTINE. 

/BODY OF INTERRUPT SERVICE ROUTINE 
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INTEXIT SERDEV 



/INTEXIT IS A SYSTEM MACRO TO CALL THE 
/ EXECUTIVE'S RESTORE ROUTINE, DEBREAK 
/ FROM HARDWARE LEVEL, AND RETURN TO 
/ INTERRUPTED TASK. 



Interrupt service routines are an integral part of a Task and must be 
connected to and disconnected from hardwaure interrupt lines before use. 
That is, before a Task can process hardware interrupts the Task must 
first connect itself to a particular API line. Likewise, when a Task 
no longer requires the use of an interrupt line it should disconnect 
and release it to the system. Note that even though several Tasks can 
connect and disconnect themselves to the same API line, only one Task 
can be connected to it at any given time. The following exeunple 
illustrates an interrupt service routine that uses the System Direc- 
tives CONNECT and DISCONNECT to connect and disconnect itself from an 
interrupt line. 
Exatmple 3: 



/CODE TO INITIALIZE A TASK 

/CONNECT INTERRUPT SERVICE ROUTINE, 
CONNECT SERDEV, 25, EV/ SERDEV, TO INTERRUPT LINE 26. 

/THE VALUE OF EV, THE EVENT VARIABLE, 
/ SHOULD BE TESTED TO INSURE THE 
/ CONNECTION WAS MADE. 



INTENTRY 



INTEXIT SERDEV 



SERDEV 



/ENTRY POINT TO INTERRUPT ROUTINE, SAVE 

/ ACTIVE REGISTERS. 

/BODY OF INTERRUPT SERVICE ROUTINE 



/RESTORE SAVED REGISTERS, DEBREAK FROM 
/ HARDWARE LEVEL, AND RETURN TO IN- 
/ TERRUPTED TASK. 

/MAIN PORTION OF TASK WHICH OPERATES AT 
/ TASK PRIORITY LEVEL. 



DISCONNECT SERDEV, 26, EV/DISCONNECT INTERRUPT SERVICE ROUTINE 

/ FROM LINE 26. 



EXIT 



/END OF TASK 
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CHAPTER EIGHT 
TASK CONSTRUCTION 



8.1 INTRODUCTION 

Task construction in the RSX environment falls into one of four dis- 
tinct categories: (1) a Task which includes computation and/or re- 
quests to I/O Handler Tasks; (2) an MCR Function Task; (3) a Front- 
End Interrupt Driver Task; and (4) an I/O Handler Task. All Tasks, 
regardless of priority, must be built with the Task Builder before 
installing into the RSX System. 

When building Tasks, the following conventions must be adhered to for 
successful operation of the RSX System: 

(1) All hardware registers are available to the programmer except 
the last 4 Autoincremerit Registers (14-17) which are used by 
the system. 

(2) A naming convention exists for Tasks in categories 2 and 4 

(see sections 8.2 and 8.4, respectively). 

(3) Tasks should not EXIT while I/O, Mark Time, or Event 
Variable settings are still pending since the Task may be 
overlayed by another Task before the operation has completed , 

(4) All Directives (viz., the issuing of the CAL instruction) 
result in a loss of the original contents of the following 
registers: AC, XR, LR, MQ, LINK, SC, Autoincrement Registers 
10-13, system registers R1-R6, and location 20. Unexpected 
interrupts which suspend normal Task execution always save 
and restore active registers before use. 

The following sections describe the different Task categories in 
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greater detail. 

8.2 COMPUTATIONAL TASK 

The computational Task is the more common type of user written Task 
since it includes programs written in FORTRAN and assembly language 
which do not have interrupt routines and I/O drivers internal to the 
Task. All necessary Input/Output is referenced through LUN slots. 

Computational Tasks require no naming conventions except the name 
must be 1-6 characters in length (Tasks called by FORTRAN programs 
must be 1-5 characters in length) . 

8.3 MCR FUNCTION TASK 

The Monitor Console Routine (MCR) consists of a resident Task called 
the Resident MCR Task, and a set of MCR Function Tasks. The Resident 
MCR Task reads a line of input from LUN 2 and REQUESTS the appropriate 
MCR Function Task which performs the MCR function. 

MCR Functions normally all share the same core partition dedicated to 
MCR Functions, however, they may be "built" to run in any partition. 

The name of the Resident MCR is "...MCR" and the name of an MCR 
Function is three periods followed by the first three characters 
of the name of the MCR Function (e.g., the TIME MCR Function is 
named ". , .TIM") . 

The Resident MCR Task is REQUESTed either by the Teletype Handler Task 
in response to a CTRL C (from LUN 2) or by an MCR Function Task. 

Two subroutines, with entry points in the System Communications (SCOM) 
area, are used by both Resident MCR and MCR Function Tasks- One (FAC) 
is used to Fetch-A -Character from a line of command input, and the 
other (IFAC) to Initialize the Petch-A-Character subroutine by 
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reading a line of conunand and setting the appropriate pointers. 
Before reading a line, "MCR>" is output (on LUN-2) to indicate that 
the MCR is waiting for input. 

The name of an MCR Function Task is formed by reading a line of commcuid 
input (IFAC) , fetching the first three characters (FAC) , and preceding 
them with three periods. After forming the MCR Function Task Name, 
the Resident MCR Task continues to fetch characters until either a 
SPACE, COMMA, CAR RTN, or ALTMODE is found. This is done so that only 
as few as the first three characters of an MCR Fvuiction need be input. 
After "flushing thru the first break character", the MCR Function 
Task is REQUESTed and the Resident MCR Task EXIT'S. If more informa- 
tion is contained in the first line of input, it will be read by the 
Function Task using the FAC subroutine. If additional lines of input 
are required by the Function Task, they are read using the IFAC and 
FAC subroutines. 

Also included in the SCOM area is the MCR Request Inhibit flag (MCRRI) 
which is examined and set by both the Teletype Handler Task and MCR 
Function Tasks. If MCRRI=Jf and a CTRL C is typed in, the Teletype 
Handler Task will REQUEST ...MCR and set MCRRI»1. If MCRRI/0 and a 
CTRL C is typed in, the Teletype Handler Task will set MCRRI=-1. 
MCRRI is cleared by MCR Function Tasks, normally just before they exit, 
or at least after they have finished fetching characters from the 
input line. MCRRI is set negative whenever a CTRL C does not result 
in REQUESTing ...MCR so that CTRL C may also be used to imply 
"premature termination" to am MCR Function with lengthy output. 

When an MCR Function has been performed, and the first line of command 
input (the line read by the Resident MCR) has been terminated by a 
CAR RTN, the Resident MCR Task is REQUESTed by the MCR Function Task. 
When the first line of command input is terminated by an ALTMODE, the 
Resident MCR Task is not REQUESTed at the completion of an MCR 
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Function, and a CTRL C typein is necessary to re-establish MCR 
dialogue. 

The MCR Function Tasks are normal Tasks that adhere to the above 
conventions related to REQUESTing the Resident MCR Task. A user may 
build his own MCR Function Tasks and is restricted only in naming it 
(the name must start with three dots) . 

The following example illustrates the structure of a typical MCR 
Function Task (TIME MCR Ftinction) . Note that the section between line 
numbers 73-78 (cross-reference line numbers) shows the standard EXIT 
procedure from an MCR Task . 
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TIM. 5 SRC 



00 

I 



1 

2 

3 

4 

5 

6 

7 

8 

9 

110 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

25 

26 

27 

2a 

29 
30 
31 
32 
33 
34 
35 



/ EDIT #S 
/ 

/ COPYRIGHT 1970, DIGITAL t-QUlPMENT CORP,, MAYNARDi MASS. 

/ 

/ MCR FUNCTlONi TIME 25 mAR 71 R. MCLEAN 

/ 

/ TASK NAMEJ ",..TIM" TO TYPE LUN^3 TIME ON THE 

/ IN RESPONSE TO THE MCR "TIME" REQUEST, 

/ 

/ THE FIRST UJNE OF COMMAND INPUT FOR ANY NCR FUNCTION IS READ 

/ BY THE RESIDENT MCR TASK (",,,mCR"), FOR THE "TIME" FUNCTION, 

/ THE SYNTAX OF THE FIRST LINE IS5 

/ 

/ SYNTAX a '•TIM"$<CHARACTer> <CR>/<AM> 

/ <character> = <letter>/<dic;it> 

/ <CR> s CAR RTN 

/ <AM> s aLTMODE 

/ 5 "ANY NUMBER OF, INCLUDING HERQ" 

/ 

/ THE RESIDENT McR READS A LINE, FETCHES THE FIRST THREE CHARACTERS 

/ TO FROM THE MCR FUNCTION TASK mAmE <",.,T1m"), FLUSHES CHARACTERS 

/ THRU THE First break or terminal char, requests "..,T1h" AND EXITS, 

/ 

/ LINE TERMINATOR, NO DATA IS TAKEN FROM THE COMMAND INPUT LI^JE. 

/ THE TASK ".,,TIM»' FLUSHES ALL CHARACTERS THRU THE END OF THE IViPUT LINE. 

/ AND SAVES THE LINE TERMINATOR, NO DATA IS TAKEN FROM THE INPUT LINE, 

/ 

/ THE TIME Is TYPED OUT "HHIMMjsS" 

/ 

/ IF THE INPUT LINE IS TERMINATeh BY A CAR RTN, THE RESIOEf^T MCR 

/ IS REQUESTED, AND THE FUNCTION TASK EXITS, 

/ 

/ IF THE INPUT LINE IS TERMINATED BY AN ALTMODE, THE FUNCTION 

/ TASK ("i.iTiM") EXITS WITHOUT REQUESTING THE RESIDENT hCR, 

/ A tC TYPEJN IS NECESSARY TO RE-ESTABLISH NCR DIALOGUE, 
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00 

I 



36 
37 
38 
39 

40 

41 
42 
43 
44 
45 
46 
47 
48 
49 
50 

H 

52 
53 
54 

55 
56 
57 
58 
59 
60 

63. 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 



00000 
00001 

00002 
00003 
00004 
00005 

00006 

00007 
00010 
00011 
00012 
00013 
00014 
00015 
00016 



000163 A 

000164 A 

000165 A 
000171 A 
000174 A 

705522 A 
705521 A 

120113 R 

540114 R 
600006 R 

540115 R 
600006 R 
600000 R 
040034 R 



705522 
220116 
040101 
220117 
040104 
705521 
220120 
040107 



00017 R 200121 

00020 R 040067 

00021 R 100044 

00022 n 100044 

00023 R 100044 



00024 R 000071 R 

00025 R 000035 R 



.TITLE •♦« MCR 
/ 

SS«163 

MM«164 
HH«165 

MCRRI»171 
FAC»174 

/ 

,|NH«705522 
,ENB"705521 
/ 



FUNCTION tTlME' 



TIME 



TIM3 



/ 



JMS« 

SAO 

JMP 

SAD 

JMP 

JMP 

OAC 

• INH 

UAC* 

OAC 

UAC* 

OAC 

.ENB 

LAC* 

OAC 

LAC 
OAC 
JMS 

JMS 
JMS 

CAl, 
CAU 



/INHIBIT INTERRUPTS 
/ENABLE INTERRUPTS 



(FAC) 

(015) 

tlM3 

(175) 

TIM3 
TIME 
TERM 



(HM) 
MHH 

(MM) 
MMM 

(SS) 

mSS 

(MHH) 

CONX 

CON 

CON 

CON 

TTPCPB 
UlAlTLP 



/FLUSH INPUT THRU TERMINATOR. AND 



///FETCH TIME 

Of 

ff* 

/// 

/// 

fft 

tf( 



/CONVERT TIME TO DECIMAL AND 
/STORE IN IMAGE ALPHA BUFFER 



/TTPE TIME 

/WAIT For tty 



TO FINISH 



T3 
74 
75 
76 
77 
78 
79 
90 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 



00026 

00027 
00030 
00031 
00032 
00033 



200034 
540H4 
000037 
540115 
160122 
000123 



00037 
00040 
00041 
00042 
00043 



EXIT 



00034 R 000000 A 

00035 R 000020 A 

00036 R 000076 R 



R 000001 A 
R 000000 A 
R 565656 A 
R 150322 A 
R 000000 A 



/ 

TERM 
/ 

WAITIP 

/ 

REQMCR 



LAC 

SAO 

CAt 

SAD 

02M» 

CAU 



20 
TYPEV 

1 



.SIXBT 

.SJXPT 



TERM 

(015} 

RlQMCR 

(175) 

(MCRRI) 

<10) 



n^ 0AR RTn TERMINATED INPUT LINE, REQUEST 
/RESIDENT MCR TASK & EXIT. IF ALTMOnE TERMINATED 
/INPUT LINE, CLEAR ^C REOUEST INHIBIT FLAG 
/AND EXIT, 



/EVENT VARIABLE ADDRESS 

/RIQUESt ",,.M0R" CPB 



"III" 

"MCR" 



/ CON «' SUBROUTINE TO CONVERT AM INTEGER TO ITS TWO DIGIT 



I 

•si 



PAGE 

92 
93 
94 
95 
96 
97 
98 
99 
100 
XH 

xn 
xn 

105 

106 

107 
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00044 


R 


000000 


A 


00045 


R 


220067 


R 


00046 


R 


160067 


R 


00047 


R 


040070 


R 


00050 


R 


723766 


A 


00051 


R 


741100 


A 


00092 


R 


600055 


R 


000153 


R 


460067 


R 


00054 


R 


600047 


R 


00055 


R 


220067 


R 


00096 


R 


240124 


R 


00097 


R 


060067 


R 
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/ DECIMAL EQUIVALENT (IMAGE AUPHA>, 'CONX' POINTS TO THE 

/ BINARY WORD, THE BINARY WORD iS REPLACED BY THE TENS 

/ DIGIT AND THE UNITS DIGIT IS STORED IN THE FOLLOWING WORD, 

/ 'CONX» IS INCREMENTED BY THREE, 

/ 

CON 



CONl 



C0N2 








UAC* 


CONX 


OEM* 


CONX 


OAC 


CONB 


A AG 


<.12 


SPA 




JMP 


00N2 


IS2» 


CONX 


J MP 


CONl 


LAC* 


CONX 


XOR 


(60) 


nAC» 


CONX 



00 

I 

00 



108 


00060 


R 


440067 


R 




ISZ 


CONX 


109 


00061 


n 


200070 


R 




LAC 


CONB 


110 


00062 


R 


240124 


R 




XOR 


(60) 


111 


00063 


R 


060067 


R 




OAC» 


CONX 


112 


00064 


R 


440067 


R 




ISZ 


CONX 


113 


00065 


R 


440067 


R 




1S2 


CONX 


114 


00066 


R 


620044 


R 




JMP* 


CON 


115 










/ 






116 


00067 


R 


000000 


A 


CONX 







117 


00070 


R 


000000 


A 


CONB 







lie 










/ 






119 


00071 


R 


002700 


A 


TVPCPB 


2700 


/rUNCTlON 


120 


00072 


R 


000076 


R 




TYPEv 


/EV ADR 


121 


00073 


R 


000003 


A 




3 


/LUN 


122 


00074 


R 


000003 


A 




3 


/MODE 


123 


00075 


R 


000077 


R 




MES12 


/BUFFFER ADR 


124 










/ 






125 


00076 


R 


000000 


A 


TYPEV 





/EVENT VARIABLE 


126 










/ 






127 


00077 


R 


006003 


A 


MES12 


006K)03 


/HEADER 


128 


00100 


R 


000000 


A 




000000 




129 


00101 


R 


000000 


A 


MHH 


000 


/HOURS 


130 


00102 


R 


000000 


A 




000 




131 


00103 


R 


000072 


A 




072 


/COLON 


132 


00104 


R 


000000 


A 


MMM 


000 


/MINUTES 


133 


00105 


R 


000000 


A 




000 




134 


00106 


R 


000072 


A 




072 




135 


00107 


R 


000000 


A 


MSS 


000 


/SECONDS 


136 


00110 


R 


000000 


A 




000 




137 


00111 


R 


000015 


A 




015 


/CR 


138 


00112 


R 


000012 


A 




012 


/If 


139 










/ 






140 






000000 


R ' 




,end 


TIME 




00113 


R 


000174 


A "L 










00114 


R 


000015 


A ^L 










00115 


R 


000175 


A •L 










00116 


R 


000165 


A *L 










00117 


R 


000164 


A •L 









00 
I 



PAGE 4 TIM. 5 SRC »»» mCR FUNCTION 'TImE' 

00120 R 000163 A »L 

00121 R 000101 R *L 

00122 R 000171 A •L 

00123 R 000010 A "U 

00124 R 000060 A *L 
SI2E»00125 NO ERROR LlNtS 



PAGE 5 TIM„5 cross REFERENCE 

96« 114 



CON 


00044 


66 


67 


68 


CONB 


00070 


99 


109 


117« 


CONX 


00067 


65 

113 


97 

116» 


98 


CONl 


00047 


99» 


104 




C0N2 


00055 


102 


105« 




EXIT 


00026 


73* 






FAC 


000174 


42« 


47 




HH 


000165 


40* 


56 




MCRRl 


000171 


41« 


77 




MES12 


00077 


123 


127» 




MHH 


00101 


57 


64 


129i» 


Mil 


000164 


39» 


58 




MMM 


00104 


59 


132» 




mSS 


00107 


62 


135* 




REQMCR 


00037 


75 


85» 




SS 


000163 


38» 


61 




TERM 


00034 


53 


73 


80« 


TIME 


00000 


47* 


52 


140 


T1M3 


00006 


49 


51 


53« 


TYPCPB 


00071 


70 


119* 




TYPEV 


00076 


83 


120 


125* 


WAITLP 


00035 


71 


82« 




,ENB 


705521 


45* 


60 




• INH 


705522 


44* 


55 





103 105 107 108 111 ll2 



SA FRONT-END DEVICE DRIVER TASK 

The Front-End Interrupt Driver Task is a Task which has both computa- 
tional and interrupt processing capabilities. Unlike the Computational 
Task, the Front-End Task has an internal interrupt routine; but it does 
not require the QUEUE I/O Directive to control it as do I/O Handler 
Tasks. 

An example Front-End Task used to generate straight line vectors on 
the VP15 storage scope is given at the end of this section (VP.6). 
This particular Task is a subroutine with four entry points for 
CONNECTing and DISCONNECTing from the interrupt line, erasing the 
display, and plotting a straight line vector. 



The following paragraphs describe the separate sections of the VP.6 
Task. 



Line Numbers* 



25-31 



4jr-47 



51-54 



Label Descriotion 

CINT Connect display interrupt 

routine, VPINT, to interrupt 
line 14. Notice that if the 
Event Varicible (EV) is negative, 
the Task EXITs since the connec- 
tion could not be made. If a 
successful connection is made, 
the EV is cleared before return- 
to the caller. 

DINT Disconnect display interrupt 

routine, VPINT, from interrupt 
line 14. The testing of the EV 
is not required here; hence, the 
address of EV in the CAL Param- 
eter Block, line number 45, is 
zero. 

ERASE Erase the face of the storage 
scope. This operation (EST) 
generates an interrupt once the 
display has been erased and re- 
quires waiting till completion. 
This is done by issuing a 
WAITFOR EV from routine WDINT 



*Line Numbers (decimal) along the left hand column of the VP.6 Task 
listing. 



8-10 



58-171 



(line 175). The interrupt 
routine, VPINT, clears the dis- 
play flag when the erase opera- 
tion has completed, sets the EV, 
and declares a Significant Event 
(Request API level 6). This 
results in a scan of the Active 
Task list and a return following 
the WAITFOR (contingent upon 
priority) . 

VECTOR This is the straight line vector 
plot routine which calculates 
the required points to generate 
the line eind displays them one 
point at a time. Following each 
point displayed, a WAITFOR is 
done to wait for the completion 
of the displayed point (line 143 
and 172). 



173-176 



WFINT Subroutine to issue a WAITFOR EV 
Directive until the point or 
erase operation has completed. 
It then clears the EV before re- 
turning. (If the EV wasn't 
cleared, the next WAITFOR EV 
issued would return immediately 
since the EV is set.) 



181-189 



VPINT Display interrupt service 

routine which sets the EV signi- 
fying the operation is complete 
and declares a Significant Event 
(Request API level 6) . The dis- 
play flag is cleared and control 
returned to the interrupted Task. 



8-11 



PAGE 1 VPf6 SRC 

1 / EDI? #6 

2 / 

3 / ERASE & VEiCTOR -- FORTRAN CAILASUE SUBROUTINE TO ERASE 

4 / SCOPEi OR TO CONSTRUCT A VECTqR FROM PKlXl.lYD TO P2 

5 / 

6 /CALLING SEUUENCESI 

7 / CALt CINt CCONNECt INTERRUPT] 

8 / CALL DINT COISCONNJECT INTERRUPT^ 

9 / CALL ERASE 

10 / CALl VECTOR ( IXli I Yl, 1X2, ly2) 

H / 

12 / 

13 700504 A LXB=7a0504 

14 700604 A Ly8s700604 

15 700724 A EST = 70«I724 

16 700521 A SODF=700921 

17 700722 A CDOF«700722 

18 700564 A LX0D8700564 

19 700664 A LY0OB700664 

20 / 

21 .GLOBL CINT, DINT, ERASE, VECTOR., DA 

22 / 

23 / CINT •>- CONNECT INTERRUPT LINE 

24 / 

25 00000 R 000000 A CINT 

26 00001 R 000007 R CAL IC 

27 00002 a 200227 R LAC EV 

28 00003 R 140227 R D^M £^ 

29 00004 R 740100 A SMA 

30 00005 R 620000 R JMP» CINT 

31 00006 R 000232 R CAL (10) 

32 / 

33 00007 R 000011 A IC 11 

34 00010 R 000227 R EV 

35 00011 R 000014 A 14 

36 00012 R 000202 R VPINT 

37 / 

38 / OINT --r DISCONNECT INTERRUPT LiNl 

39 / 



40 


00013 


R 


000000 


A 


0!NT 





41 


00014 


R 


000016 


R 




CAl. ID 


42 


00015 


R 


620013 


R 




JMP* OlNT 


43 










/ 




44 


00016 


R 


000012 


A 


ID 


12 


45 


00017 


R 


000000 


A 







46 


00020 


R 


000014 


A 




14 


47 


00021 


R 


000202 


R 




VPINT 


48 










/ 




49 










/ Erase 


-■- ERASE STOR 


50 










/ 




51 


00022 


R 


000000 


A 


ERASE 





52 


00023 


R 


700724 


A 




EST 


53 


00024 


R 


100174 


R 




JMS WFINT 


54 


00025 


R 


620022 


R 




JMP* fRASE 


55 










/ 





« PAGE 2 VPf6 SRC 

^ 56 /VECTOR -- CONSTRUCT LINE 

57 / 

58 00026 R 000000 A VECTOR 

99 00027 R 120231 E JMS« ,DA /Ft'CH ARGUMENT ADDRESSES 

60 00030 R 600035 R JMP ,♦5 

61 00031 R 000000 A XI 

62 00032 R 000000 A Yl 

63 00033 R 000000 A X2 

64 00034 R 000000 A y2 

65 / 

66 00035 R 220031 R LAC* Xl /D&TERM'mE OELTA-X S X-INCR POLA 

67 00036 R 740031 A TCA 

68 00037 R 360033 R TAO* X2 

69 00040 R 722000 A PAL 

70 00041 R 741100 A SPA 

71 00042 R 740031 A TCA 

72 00043 R 040213 R DAC DELX 

73 00044 R 730000 A PLA 

74 00045 R 751100 A SPATCkA 

75 00046 R 777776 A LAW -2 



00 



76 


00047 


R 


740030 A 


77 


00050 


R 


040215 R 


78 








79 


00051 


R 


220032 R 


80 


00052 


R 


740031 A 


81 


00053 


R 


360034 R 


82 


00054 


R 


722000 A 


83 


00055 


R 


741100 A 


84 


00056 


R 


740031 A 


85 


00057 


R 


040214 R 


86 


00060 


R 


730000 A 


87 


00061 


R 


751100 A 


S8 


00062 


R 


777776 A 


89 


00063 


R 


740030 A 


90 


00064 


R 


040216 R 


91 








92 


00065 


R 


200214 R 


93 


00066 


R 


740031 A 


94 


00067 


R 


340213 R 


95 


00070 


R 


741100 A 


96 


00071 


R 


600113 R 


97 








98 


00072 


R 


200213 R 


99 


00073 


R 


040223 R 


100 


00074 


R 


200214 R 


101 


00075 


R 


040226 R 


102 


00076 


R 


220031 R 


1213 


00077 


R 


040221 R 


104 


00100 


R 


220032 R 


105 


00101 


R 


040217 R 


lt!l6 


00102 


R 


200233 R 


107 


00103 


R 


040171 R 


108 


00104 


R 


200234 R 


109 


00105 


R 


040165 R 


110 


00106 


R 


20021S R 



lAC 
DAC 

LAG* 

TCA 

TAO« 

PAL 

SPA 

TCA 

DAQ 

PLA 

SPASCLA 

LAW 

lAC 

DAC 

LAC 
TCA 
TAD 
SPA 
JMP 

LAC 

OAC 

LAC 

OAC 

LAC* 

OAC 

LAC* 

OAC 

LAC 

OAC 

LAC 

DAC 

LAC 



XINC 

Yl 

Y2 



OELY 



YINC 
DELY 
DEUX 
V2 



/DETERMINE DELTA-Y & Y-INCR POLA 



/IS DELTAaX GREATER THAN OR EQUAL 



/YES -« INITIALIZE POR H0RI2 LARGE 
/NO ^-^ INITIALIZE FOR VERT LARGE 



OELX /NCsOELX 

NC 

DELY /NRsQELY 

NR 

Xl /LCC»X 

I cc 

Yl /SCC'Y 

sec 

axBD) /lcm«lxbd 

lcm 

(lyb) /scm«lyb 

SCM 

XINC /LCl'XlNC 



PAGE 



VPiA 



SRC 



00 

I 



Ul 



111 


00107 


R 


040222 


R 




OAC 


UCl 




112 


00110 


R 


200216 


R 




t.AC 


YINC 


/SCI«YINC 


113 


00111 


R 


040220 


R 




OAC 


SCI 




114 


00112 


R 


600133 


R 




JMP 


V3 




lis 










/ 








116 


00113 


R 


200214 


R 


V2 


LAC 


DELY 


/nckdely 


117 


00114 


R 


040223 


R 




OAC 


mC 




118 


001115 


R 


200213 


R 




LAC 


OELX 


/nw=delx 


119 


00116 


R 


040226 


R 




OAC 


ivR 




120 


00117 


R 


220032 


R 




LAC* 


Yl 


/lcc»y 


181 


00120 


R 


040221 


R 




OAC 


LCC 




122 


00121 


R 


220031 


R 




LAC* 


xl 


/scc=x 


123 


00122 


R 


040217 


R 




OAC 


sec 




124 


00123 


R 


200235 


R 




LAC 


(UYBO) 


/'L'^M«l,YBD 


129 


00124 


R 


040171 


R 




OAC 


LCM 




126 


0012» 


R 


200236 


R 




LAC 


axB) 


/scm«lxb 


127 


00126 


R 


040165 


R 




OAC 


SCM 


■ 


128 


00127 


R 


200216 


R 




LAC 


YlNC 


/lci»yinc 


129 


00130 


R 


040222 


R 




DAC 


LCI 




130 


00131 


R 


200215 


R 




LAC 


XINC 


/SCI«XINC 


131 


00132 


R 


040220 


R 




DAC 


SCI 




132 










/ 








133 


00133 


R 


200223 


R 


V3 


LAC 


NC 


/NTsNC 


134 


00134 


R 


040224 


R 




DAC 


NT 




135 


0013'J 


R 


744020 


A 




RCR 




/NAsNC/2 


136 


00136 


R 


040225 


R 




OAC 


na 




137 










/ 








138 


00137 


R 


220031 


R 




LAC* 


XI 


/PLOT INITIAL 


139 


00140 


R 


700504 


A 




LXB 






140 


00141 


R 


220032 


R 




LAC* 


Yl 




141 


00142 


R 


700664 


A 




LYSO 






142 


00143 


R 


100174 


R 




JMS 


WFINT 




143 










/ 








144 


00144 


R 


200223 


R 


Pll 


LAC 


NC 


/NC=0 ? 


145 


0014:5 


R 


741200 


A 




SMA 






146 


00146 


R 


620026 


R 




JMP* 


VECTOR 


/Yes -:t EXIT 


147 


00147 


R 


723777 


A 




AAC 


-1 


/NO »•*- NC^NC-1 


148 


00150 


R 


040223 


R 




OAC 


MC 





149 

t50 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 



00151 


R 


200225 


R 




LAC 


na 


00152 


R 


340226 


R 




TAO 


MR 


00153 


R 


040225 


R 


/ 


OAC 


NA 


00154 


R 


200224 


R 


l,AC 


NT 


00155 


R 


740031 


A 




TCA 




00156 


R 


340225 


R 




TAD 


MA 


00157 


R 


741100 


A 




SPA 




00160 


R 


600166 


R 




JHP 


PL2 


00161 


R 


040225 


R 




DAC 


NA 


00162 


R 


200217 


R 




LAC 


sec 


00163 


R 


340220 


R 




TAO 


SCI 


00164 


R 


040217 


R 




DAC 


sec 


00165 


R 


740040 


A 


SCM 

/ 

PL2 


XX 




00166 


R 


200221 


R 


LAC 


LCC 



/MA3NA*NR 



/na>nt 



/nQ — DO LAR5E COUNT MOVEMENT 
/¥tS — nAbMAbNT « COMBINED MOVE 
/SMALL. COUNT MOVEMENT 



/(lYB Or t,XB) 

/L*RCE COUNT MOVEMENT 



00 

1 



PAGE 

166 
167 
168 
169 
170 
171 
172 
173 
174 
175 
176 
177 
178 
179 
180 
161 
182 
183 
184 



VPt6 



SRC 



00167 R 340222 R 

00170 R 040221 R 

00171 R 740040 A 

00172 R 100174 R 

00173 R 600144 R 



00174 
00175 
00176 
00177 



000000 
000200 
140227 
620174 



00200 R 000020 A 

00201 R 000227 R 

00202 R 000000 A 

00203 R 040230 R 

00204 R 440227 R 

00205 R 200237 R 



LCM 
/ 

/ 

WFlNT 



/ 

WFCPB 

/ 

VPINT 



TAD 
OAC 
XX 
JMS 

JMP 

3 

CAL 
02M 
JMP* 

20 
£V 



OAC 
ISZ 

LAC 



lCI 

LCC 



/(LXBD OR LYBD) 



WFINT 

PUl /TO EXIT TEST 



wrcpB 

EV 

wriNT 



aCbuf 

EV 
(401000) 



00 
I 



$.85 


00206 


R 


705504 


A 






ISA 


136 


00207 


R 


700722 


A 






COOK 


187 


00210 


R 


200230 


R 






LAC aCBuF 


188 


00211 


R 


703344 


A 






08R 


189 


00212 


R 


620202 


R 






JMP* VPlNT 


190 












7 




191 


00213 


R 


000000 


A 




DEUX 





192 


00214 


R 


000000 


A 




DEIY 





193 


00215 


R 


000000 


A 




XlNC 





194 


00216 


R 


000000 


A 




YINC 





195 


002117 


R 


000000 


A 




sec 





196 


00220 


R 


000000 


A 




SCI 





197 


00221 


R 


000000 


A 




lcc 





198 


00222 


R 


000000 


A 




lcj 





199 


00223 


R 


000000 


A 




NC 





g00 


00224 


R 


000000 


A 




NT 





?01 


00225 


R 


000000 


A 




NA 





202 


00226 


R 


000000 


A 




MR 





203 


00227 


R 


000000 


A 




EV 





204 


00230 


R 


000000 


A 




ACBur 





205 












/ 




206 






000000 


A 






• END 




00231 


R 


000231 


E 


• E 








00232 


R 


000010 


A 


«L 








00233 


R 


700564 


A 


»L 








00234 


R 


700604 


A 


«L 








00235 


R 


700664 


A 


•L 








00236 


R 


700504 


A 


»L 








00237 


R 


401000 


A 


»L 








SIZE*00240 






NO ERROR 


LINES 



/OfeLTA-X 

/DELTA»y 

/X INCREMENT {*1 OR «1) 

/Y INCREMENT C*l QR •!> 

/small count coordinate 

/smalu count increment 

/l*rge count coordinate 

/l*rge count increment 



RASE 



VP,6 CROSS REFERENCE 





ACBUP 


00230 


182 


187 


204» 








CDDF 


700722 


17« 


186 










CINT 


00000 


21 


25* 


30 








OELX 


00213 


72 


94 


98 


118 


191* 




OEIY 


00214 


85 


92 


100 


116 


192* 




DINT 


00013 


21 


40« 


42 








ERASE 


00022 


21 


51» 


54 








EST 


700724 


15# 


52 










EV 


00227 


27 


28 


34 


175 


179 183 




IC 


00007 


26 


33* 










ID 


00016 


41 


44* 










LCC 


00221 


103 


121 


165 


167 


197* 




LCI 


00222 


111 


129 


166 


198* 






LCM 


00171 


107 


125 


I6e« 








LXB 


700504 


13* 


126 


139 








LXBD 


700564 


18* 


106 










LYB 


700604 


14* 


108 










LYBD 


700664 


19* 


124 


141 






CO 
1 


NJA 


00225 


136 


150 


152 


156 


159 201« 


M 


NC 


00223 


99 


117 


133 


144 


148 199» 


00 


HH 


00226 


101 


119 


151 


202» 






NT 


00224 


134 


154 


200* 








PLl 


00144 


144* 


171 










PU2 


00166 


158 


165* 










sec 


00217 


105 


123 


160 


162 


195* 




SCI 


00220 


113 


131 


161 


196* 






SCM 


00165 


109 


127 


163« 








SDOF 


700521 


16* 












VECTOR 


00026 


21 


58« 


146 








VPINT 


00202 


36 


47 


181* 


189 






V2 


00113 


96 


116« 










\/3 


00133 


114 


133* 










wrcpB 


00200 


174 


178* 










WFINT 


00174 


55 


142 


169 


173* 


176 




XINC 


00215 


77 


110 


130 


193# 






n 


00031 


61* 


66 


102 


122 


138 




xz 


00033 


63* 


68 










YINC 


00216 


90 


112 


128 


194« 






Yl 


00032 


62* 


79 


104 


120 


140 




YZ 


00034 


64* 


81 










,0A 


00231 


21 


59 









203* 



8.5 I/O HANDLER TASK 

An I/O Handler Task is a Task dedicated to the control of an I/O Device 
Unit. I/O requests to these Tasks are made to Logical Unit Numbers 
and are queued at the requestor's priority. (See section 7.5 for a 
complete description of I/O operations in an I/O Handler Task . ) 

A naming convention exists for I/O Handler Tasks (Task Building Name) , 
requiring the name to be two characters in length followed by four 
periods, respectively (e.g., LP...., PP...., and PR....). 

An example I/O Handler Task used to drive the LP15C Line Printer is 

given at the end of this section. The following paragraphs describe 

the separate sections of the Line Printer Handler, LP. 5. 

Line Number* Label Description 

78-104 START This is the Handler initializa- 

tion section required by all I/O 
Handler Tasks. Between lines 
78-84, the Physical Device List 
(PDVL) is scanned for a node for 
this device. If found (line 85) , 
the device Name (line lj92) was 
found in the PDVL and a node is 
returned in the AC. If not 
found (line 84), the Task EXITs 
since no node having the neune 
"LP" was found in the PDVL. 
Once the node address is return- 
ed in the AC, the address of the 
Trigger Event Variable in the 
node is calculated and saved 
(line 87) . The interrupt line 
is then CONNECTed (if no connec- 
tion was made the Task EXITs) 
and the address of the Trigger 
Event Variable is placed in the 
Physical Device node (line 92). 
Lines 94 to 96 calculate an ad- 
dress to be used by the Index 
Register later when obtaining 
arguments from the PDVL. The 
Handler then clears the con- 
troller and waits for the 
Trigger Event Variable, TG, to 
be set (WAITFOR TG) . 



* Line Numbers (decimal) along the left hand column of the LP. 5 Task 
listing. 

8-19 



115-146 PQ The Trigger Event Variable has 

been Triggered. (The CAL 
Service Routine in the Executive 
Triggers the Event Variable 
whenever the Handler has an I/O 
request.) The Trigger is clear- 
ed (line 118) to prevent the 
Handler from being inadvertently 
called when the WAITFOR TG is 
again issued. At line 120 the 
request is de-queued (removed 
from the queue) and if the queue 
is empty, the Handler issues a 
WAITFOR TG Which will be set at 
the next I/O request for this 
device. If a node was de-queued, 
the Event Variable and CAL 
Function are removed and tested. 
If the user's Event Variable ad- 
dress (line 128) is zero, the 
handler substitutes an internal 
Event Variable to handle I/O 
completion indications. The CAL 
Function is then tested for 
ATTACH, DETACH, etc When de- 
queuing a request (line 122) , if 
the de-queue was not made (empty 
queue) return from DQRQ is im- 
mediately following the JMS, 
otherwise the return is JMS+2 
(line 125) . If the de-queue was 
made, the AC will contain the 
address of the de-queued node. 
If not, the AC contains either 
zero, if the queue was empty, 
or non-zero if the device has 
been ATTACHed. This is useful 
when device handlers are multi- 
unit and the REASSIGN MCR Func- 
tion removes one of its units 
from the LUT. 

15jaf-173 ATTACH Routines to ATTACH, DETACH, and 

return Handler Information 
(HINF) , 

174-293 PRINT Routines to prepare information 

for and handle the hardware of 
the LP15C. Notice lines 243-246 
declare a Significant Event in- 
dicating that a line has effec- 
tively been printed. 

327-338 INT This is the interrupt service 

routine which reads the status 
of the Line Printer (always non- 
zero) and saves it in the Hand- 
ler's Event Variable. A Signif- 
icant Event is then declared and 
return given to the interrupted 
program. 

355-38J2f CCPB CPB's used by the Handler. 
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PAGE 



LPi6 



SRC 



00 

I 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
H 
12 
13 
14 
IS 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 



EDIT #6 

COPYRIGHT 1971, DIGITAL E-QUIPMENT CO«P.i MAYMARO, MASS. 

RSX PRINTER HANDLER TASK l/APR/71 H, KREJCI 

THIS HANDLER TaSK IS TO DRIVE THE LP15C HARDWARE, IT IS COMPATABLE 
WITH NORMAL OUTPUT FROM FORTRAN « MACRO WRITTEN PROGRAMS. OUTPUT IH 
IMAGE MODE AND OUTPUT NOT BEGINNING WITH A '12'» '14', '?0', OR '21' 
CHARACTER IS PRECEDED BY AN UpsPACE (LINEFEED) AND PRINTED DIRECTLY 

FROM THE Indicated core, ascii output beginning with one of the above 

VERTICAL CONTROL CHARACTERS (E.G.i OUTPUT VIA FORTRAN OTS) IS MOVED TO 
A BUFFER WITHIN THIS HANDLER WHERE THE HEADER AND POSSIBLY THE LE:ADI^!n 
CONTROL CHARACTER (FOR QVERPRINTj IS HODIFIEO AND THE LINE (CONiSIDERFD 
Two LINES BY THE HARDWARE WHiCH TERMINATES LINES AT VERTICAL CONTROL 
CHARACTERS) IS PRINTED, 

THERE ARE NO IMPOSED PAGE EJECTS AT PAGE BOTTOMS, 

THE FOLLOWING CAL PARAMETER BLOCKS ARE USED TO QUEUE REQUESTS FOR 
PRINTER SERVICfJ 



CPB 



CPB 



CPB 



CPB 



3600 

EV 

LUN 

2400 

EVA 

i.UN 

?700 
EVA 

LUN 

MODE 

LINE 

2500 
FVA 

LUN 



/HANDLER Information (hinf> 



ATTACH PRINTER 



PRINT LINE 



DETACH PRINTER 



40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 







/ 






/ THE REQUES 






/ IS QUEUED 






/ PREFORMEOi 






/ IF THE REU 






/ OF THE FOL, 

/ 

/ -5 










/ 1-6 






/ -24 






/ 


000012 


A 


X12S12 


000013 


A 


X13»13 


000101 


A 


Rl'lSi 


000102 


A 


«2»102 


000107 


A 


MAOO«107 



TOR'S EVENT VA«lABlE IS CLEARED <EEROED) WHEN THE REQUEST 
BY THE "QUEUE I/O" DIRECTIVE. IF THE REQUEST CAN BE 

THE EVENT VARIABLE l5 SET TO ONE (♦!) UPON COMPLETION. 
UEST CANNOT BE PERFORMED, THE EVENT VARIABLE IS SET TQ ONE 
LOWING NEGATIVE VALUESI 

-« Data MODE (HEADER) DISAGREES WITH REQUEST MODE 

-- ILLEGAL REQUEST FUNCTION 

-- LUN HAS BEEN REASSIGNED WHILE REQUEST WAS IN QUEUE 

/AUTO-INCRtMENT bEG i2 
/AUTO^INCREMENT bEG 13 
/RE-ENTRANT REGISTER ONE 
/RE-ENTRANT REGISTER TWQ 
/NODE ADDITION ROUTINE ENTRY POINT 






PAGE 

56 
57 
58 
59 
60 
61 
62 
63 
64 
65 

66 
67 
68 
69 
70 
71 
72 
73 
74 



LPi6 



SRC 



000123 


A 


SNAMB123 


000240 


A 


POOL»240 


000252 


A 


PDVL«252 


000325 


A 


ALAD«325 


000332 


A 


DUAD=332 


000337 


A 


D0RQS337 


000010 


A 


DiTG»10 


000034 


A 


WCAa34 


000035 


A 


CAAa35 


706541 


A 


LPP1S706541 


706521 


A 


LPPMe706521 


706552 


A 


LPRSS706552 


706544 


A 


LPEI»706544 


706561 


A 


LPDIe706561 


706621 


A 


LPCDS706621 


706641 


A 


LPCS«706641 

/ 

L8F 002002 


00000 R 002002 


A 


00001 R 000000 


A 


000000 



IN POVL NODE 
CONTROLLER) 



/NAME SCAN ROUTINE ENTRY POINT 
/LISTHEAO FOR PooL OF EMPTY NODES 
/UISTHEAD FOR PHYSICAL DEVICE LIST 
/ATTACH LuN « DEVJCE ENTRY POINT. 
/DETACH LUN « DevICE ENTRY POINT 
/OE'^OUEUE REQUEST ENTRY POINT 
/POSITION OF TRIGGER EVENT VARIABLE 
/WORD COUNT ADDRESS (NOT USED BY LP 
/CURRENT ADDRESS REGISTER ADDRESS 
/PRINT ONE LINE 
/PRINT MULTIPLE ulNE 
/READ LP STATUS 
/ENABLE LP INTERRUPTS 
/DISABLE LP INTERRUPTS 
/CLEAR LP OONE FlAG 
/CLEAR LP STATUS AND ERROR FLAGS 



/INTERNAL LINE BUFFER HEADER 
/INITIALI2ATI0N CODE IS USED FOR TEXT BUFFER 



CO 

I 

to 

to 



75 

76 
77 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 

91 
92 

93 

94 

95 

96 

97 

98 

99 

100 

101 

102 

103 
104 
105 
106 
107 
106 
109 



00002 
00003 
00004 
00005 
00006 

000(97 

00010 

00011 
00012 
00013 
00014 
00015 
00016 
00017 
00020 
00021 
00022 
00023 

00024 
00025 
00026 



R 200416 R 
R 0^0417 R 
R 200420 R 
R 060421 R 
R 120422 R 



000423 

040355 

723010 

040356 

000357 R 

200347 R 

741100 

000423 

200424 

060356 

500425 

740031 

040342 



R 706621 A 
R 706641 A 
R 600070 R 



00027 R 142000 A 
00030 R 000000 A 



00031 R 



/ HANDLER INITIALIZATION 
/ 



START 



HNAM 



I.AC 

DAC» 

LAC 

DAG* 

JMS« 

CAL 

OAC 

AAC 

OAC 

CAL 

LAC 

SPA 

CAL 

LAC 

DAC* 

AND 

TCA 

DAC 

LPCO 
LPCS 
JMP 



(POVL) 

(Rl) 

(HNAM) 

{R2> 

(SNAM) 

(10) 

POVNA 

♦ 0.T5 
pDVTA 
CCPB 
EV 

(10) 

( Te ) 

PDVTA 
(070000J 

XAOJ 



/SCAN PHYSICAL DEVICE LIST FOR FOR NODE 

/FOR THIS device:. 



^{H, R2, R6, XR, 4; AC ARE ALTERED) 

/NODE Pound? 

/NO •« EXIT 

/SAVE PDVt NODE ADDRESS 

/AND TRIGGER EVENT VARIABLE ADDRESS 

/TRIGGER Event variable address address, 

/CONNECT INTERRUPT LINE 

/CONNECT Okay? 

/NO "•' EXIT 

/YlS -• SET TRIGGER EVENT VARIABLE ADDRESS 

/IN PHYSICAL DEVICE NODE 

/DETERMINE "XR^ADJ" 



WFTGR 



.SIXBT "LP»l»f»" 



/CUEAR LP CONTROLLER 
/WAJT FOR TRIGGER 
/HANDLER TASK NAME 



/END OF INITIALIZATION CODE 
, BLOCK 66*START", 



ttttftttttfttttt 
♦ft»»tttt»tttttt 



THE ABOVE CODE IS OVER* t t t t t t t t t t t t t t t t t r 
LAYED BY 0T5 aSCII LINES 1 1 1 1 1 r 1 1 1 1 1 1 1 1 ♦ 1 1 



PAGE 



LPi6 



SRC 



to 



110 
111 

112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 



00070 R 000373 R 



00071 R 140354 R 



00072 

00073 
00074 

00075 
00076 
00077 
00100 
00101 
00102 
00103 
00104 

00105 
00106 
00107 
00110 
00111 
00112 
00113 
00114 
00115 
00116 
00117 
00120 
00121 
00122 



R 200355 R 
R 060417 R 
R 120426 R 



600070 
040353 
340342 
721000 
210006 
R 741200 
R 200427 
R 040352 



210005 A 

500430 R 

540431 R 

600123 

540432 

600132 

540433 

600143 

540434 R 

600141 R 

540430 

600302 

777772 

600315 



/ 

/ WAIT 

/ TO S 

/ 

WFTGR 

/ 

/ THE 

/ 

/ 



roR Task to be triggered oy •i/o cal' cal service routine) 

IGNAL that a request HAS BEEN QUEUEOi 

cal wFTCPB /wait For trigger event VARIABLE TO BE SET 
TASK HAS BEEN TRIGGEl^EP «- PICK A REQUEST FROM QUEUE (IF AMY) 



OZM 

LAC 
DAC» 

JMS« 

JMP 
DAC 
TAD 
PAX 
LAC 
SNA 
LAC 
OAC 

LAC 
AND 
SAO 
JMP 
SAO 
JMP 
SAD 
JMP 
SAO 
JMP 
SAD 
JMP 
LAW 
JMP 



TG 

POVNA 

(Rl! 

(DORO) 

WFTGR 

RN 

XADJ 

6»X 

(RE) 

RE 

5,X 

(777) 

(024) 

ATTACH 

(025) 

DETACH 

(027) 

PRINT 

(036) 

WlNF 

(777) 

OAEX 

^6 

SEV 



/CLEAR TRIGGER 

/DE-OUEUE A REQUEST 

/(Rli R2, R4, R5, R6. XR, & AC ARE ALfERED) 

/WAS A REQUEST FOUND? 

/NO -^ WAIT FOR TRIGGER 

/YES w« SAVE ADDRESS OF REQUEST NODE 

/SETUP XR TO ACCESS NODE 

/SAVE AOORISS OF REQUESTOR'S EVENT VARIABLE 



/FtTCM CAL FUNCTION CODE 

/ATTACH REQUEST? 

/YES -• ATTACH TO A TASK 

/NO "'" DETACH REQUEST? 

/Y^S -w DETACH FROM TASK 

/NO -" PRINT REQUEST? 

/YES ^-^ WRITE RECORD 

/NO ^- HANDLER INFO REQUEST? 

/YES »" RETURN INFO IN EVENT VARIABLE 

/NO ••■' EXIT (DEASSIGNED) REQUEST? 

/YES 1-" oEaTTACH & EXIT 

/NO -•' UNlMPLlHENTEO FUNCTION -■< SET 

/EVENT VARIABLE TO -6 



i48 / ATTACH TO A TASK 

150 00123 R 200355 R ATTACH LAC PDVNA /ATTACH lUN S DEVICE 

151 00124 R 060417 R OAC* (Rl) 

152 00125 R 200353 R LAC RN 

153 00126 R 060421 R DAC« (R2) 

154 00127 R 120435 R JMS« tALAO) /(R3| R4, R5, R6, X10, Xll, XR, ^ AC ARE ALTERED) 

155 /WAS LUM ATTACHED? 

156 00130 R 600315 R JMP SEV /nO ^* SF.T REQUESTOR'S EVENT VARIABLE TO ?24 

157 00131 R 600314 R JHP REQCMP /yES -- REQUEST COMPLETED 

158 / 

159 / DETACH FROH A TASK 

160 / 

161 00132 R 200355 R DETACH LAC PPVNA /DETACH lUN S DEVICE 

162 00133 R 060417 R DAC* <Rl) 

163 00134 R 200353 R LAC RN 

164 00135 R 060421 R DAC* (R2) 

CO 

I 

^ PAGE 4 LPi6 SRC 

165 00136 R 120436 R JMS» (PLAO) /(K3, R4. R5, R6. X10, Xll, XR, & AC ARE ALTERED) 

166 /WAS LUM DETACHED? 

167 00137 R 600315 R JMP SEV /NO -- SET REQUESTOR'S EVENT VARIABLE TO «'?4 
16B 00140 R 600314 R JMP REQCMP /Y^S -« REQUEST CONPLETED 

169 / 

170 / RETURN HANDLER INFORMATION IN EVENT VARIABLE 

171 / 

172 00141 R 200437 R HINF LAC (100011) 

173 00142 R 600315 R JMP SEV 

174 / 

175 / PRINT LINE 

176 / 

177 00143 R 210010 A PRINT LAC 10iX /S^T HEADER ADDRESS 

178 00144 R 040350 R DAC hXI 

179 00145 R 723002 A AAC *2 /St.T TEXT ADDRESS 
1B0 00146 R 040351 R OAC HX2 

181 00147 R 220350 R LAC» HXl /GtT MODE INDICATOR FROM HEADER 

182 00150 R 500440 R AND (003) 



CTl 



183 

184 
185 
186 
187 
188 
169 
190 
191 
192 
193 
194 
195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 
218 
219 



00151 
00152 
00153 
00154 
00155 
00156 
00157 
00160 
00161 
00162 
00163 
00164 
00165 
00166 
00167 
00170 
00171 
00172 
00173 



00174 
00175 
00176 
00177 

00200 

00201 
00202 



550007 
600155 
777773 

600315 
540440 
600174 
220351 
500441 
540442 R 
600206 R 
R 540443 
R 600206 
R 540444 
R 600206 
R 540445 
741000 
600174 
200446 
600206 



200447 R 

100246 R 

706541 A 

200350 R 

100246 R 

706541 A 

600314 R 



00203 R 002003 A 

00204 R 000000 A 

00205 R 000012 A 



SAD 

JMP 

LAW 

JMP 

SAD 

JMP 

LAC* 

AND 

SAD 

JMP 

SAQ 

JMP 

SAD 

JMP 

SAO 

SKP 

JMP 

LAC 

JMP 



7iK 

il' 

SEV 
(3> 

UBM 
HX2 



/DOES Data mooe agree with request mode? 

/NO -"" SET EVENT VARIABLE TO -5 



/YES -f IMAGE MODE? 

/YES --•» uNeUFrEDED MODE 

/NO — FETCH FIRST CHARACTER OF TEXT 
(774000)/ANO TEST FOR LINE TERMINATIMG CONTROL CHARACTER 
(050000)/LlNE FECD (12)? 

BFM /YES -"" SUFFERED MODE WITH LF IN AC BITS 0-6 
(060000)/NO -, roRM FEED (14)7 

BFM /YES -9 BUFFERED MODE WITH FF IN AC BITS 0«6 
{104000)/NO *- DOUBLE SPACE (21)? 

8FM /YlS -• BUFFERED MODE WITH DS IN AC BITS 0i!.6 
rl00000)/NO >" OVERPRINT (20)? 

/YES "* BUFFERED MODE WITH CR IN AC BITS 0-6 



UBM /NO 

(064000) 

eFM 



/ UNBUFFERED OUTPUT MODE o" 
/ LINE FROM THE REQUESTOR'S 
/ 



UNBUFFERED MODE 



upspaCe forms, and 
buffe« in the mode 



PRINT A SINGLE 
INDICATED BY THE HEADER. 



UBM 



/ 

LFL 



LAC 

JMS 

LPPl 

LAC 

JMS 

LPPl 

JMP 

002M03 
000000 
000012 



(LFL) 
PRNT 

HXl 
PRNT 



/PRINT LINEFEED LINE 



/PRINT REQUESTED LlNE 



reocmp /request Completed 
/linefeed line 



/ BUFFERED OUTPUT 
/ CONTROL CHaR is 



MODE 
»20« 



-* MOVE 5/7 PACKED LINE 
(OVERPRINT), CHANGE TO 



TO BUFFER IN HANDLER, IF 
•15», AND PRINT THE TWO 



PAGE 



UP. 6 



SRC 



00 

I 
ro 

-J 



220 
221 
222 

223 
224 
229 

226 
227 
228 
229 
230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 
246 
247 
248 
249 
290 
251 
292 
253 
294 
295 
296 
897 



00206 
00207 
00210 
00211 
00212 
00213 
00214 
00215 
00216 
00217 
00220 
00221 
00222 
00223 
00224 
00225 
00226 
00227 
00230 
00231 

00232 
00233 
00234 
00235 

00236 
00237 
00240 
00241 

00242 
00243 
00244 



040344 
220350 
640510 
500450 
740031 
040346 
723066 
740100 
600221 
777712 
040346 
200350 
740030 
060451 
200452 
060453 
220012 
060013 
440346 
600226 



R 200457 
R 100246 
R 706521 



/ LINES (CONT CHAR & TEXT) IN Ascll MODE, 
/ 

BFM 



R 200454 R 

R 060352 R 

R 200455 R 

R 705504 A 

R 200002 R 
R 500456 R 
R 240344 R 
R 040002 R 



00245 R 600320 R 



DAC 

LAC* 

LRS 

AND 

TCA 

DAC 

AAC 

SMA 

JMP 

LAW 

DAC 

LAC 

lAC 

DAC* 

LAC 

DAC* 

LAC* 

DAC* 

iSi 

JMP 

LAC 
DAC* 
LAC 
ISA 

LAC 
AND 
XOR 
DAC 

LAC 
JMS 
LPPM 

JMP 



/SAVE Control char 

/MOVE Text to internal buffer 



CCBF 
MXl 
10 
(776) 

CNT 
4.66 

1*3 
• 66 

CNT 
HXl 

(X12) 

a@F*i) 

(X13) 

Xl2 
Xl3 

CNT 



<*1> /SIT REQUESTOR'S EVENT VARIABLE TO *1 AND 
RE /OlCLARE A SIGNIFICANT EVENT (LINE HAS BEEN 
(40l000)/EFFECTlvELY PRINTED) 



LBr*2 /CHANGE CONTROL CHAR TO '15» IF •20' 

(003777) 

CCBF 

LBF*2 



(LBF) 

PRNT 



RNTP 



/PRINT TWO LINES 



/RETURN REQUEST NODE TO POOL AND PROCESS NEXT REQUEST 



258 
259 
260 
261 
262 
263 
264 
265 
266 
267 
268 
269 
27et 
271 
272 
273 
274 



00246 R 

00247 P 

00250 R 

00251 R 
00252 
00253 
00254 
00255 

00256 R 

00257 R 



000000 A 
140301 R 
723777 A 
040345 R 
060460 R 
160461 
420246 
140347 
706544 
000375 



00260 R 200347 R 

00261 R 500462 R 



/ 

/ PRNT 't 
/ IN AC, 
/ 

PRNT 



. SyeROUTjNE TO 
ANU THE IQT TO 



PRINT A LINE, THE LINE BUFFER ADDRESS 
PRINT IS IN THE LOCATION FOLLOWING THE 



IS 

JMS, 



PRNTl 





DZM 

AAC 

OAC 

DAC« 

DZM» 

XCT« 

OZM 

LPEI 

CAL 

LAC 
AND 



PRNTEF 
il 

CABF 
(CAA) 

(WCA) 
PRNT 

rv 

WFECPB 



/CLEAR ERROR f^LAG. 
/D^TERMimE £ SAVE 



CURRENT ADDRESS 



/SET CURRENT ADDRESS 

/PREVENT WORD COUNT OVCRFLOW 

/E>fECUTE PRINT lOTi CLEAR EVENT VARIABLE, 

/ENABLE lP INTERRUPT, AND WAIT FOR THE EVENT 

/VARIABLE TO BE SET NON-iZERO BY THE INTERRUPT 

/SERVICE ROUTINE. 

/INTERRUPT HAS OCCURRED *« EXAMINE PRINTER STATUS, 



EV 

(200000)/ALARM ERROR? 



to 

00 



PAGE 

275 
276 
277 
278 
279 
280 
281 
282 
283 
284 
285 
286 
287 
288 
289 
290 
291 
292 
293 



LP. 6 

00262 
00263 
00264 
00265 
00266 
00267 
00270 
00271 
00272 

00273 
00274 
00275 
00276 

00277 
00300 



SRC 



741200 
600277 

200301 
740200 
600273 

000377 
R 000375 
R 200454 
R 040301 



R 000367 R 

R 000375 R 

R 200345 R 

R 600252 R 

R 440246 R 

R 620246 R 



00301 R 000000 A 



/ 

PRNT2 



PRNTXT 

/ 

PRNTEF 



SNA 
JMP 
LAC 
SZA 
JMP 
CAL 
CAL 
LAC 
DAC 

CAL 
CAL 
LAC 
JMP 

ISZ 

JMP* 





PRNTXT /NO -* EXIT PRNT SUBROUTINE 
PRNTEF /NEW ERROR? 



PRNT2 

TEMCPB 

wFECPB 

(1) 

PRNTEF 



MTCP8 /DELAY 

wFECPB 

CABF /RETRY 

PRNTl 



pRNT 
PRNT 



/NO -« DELAY AND RETRY 
/YES — • TYPE ERR MESSAGE 



/EXIT PRmT subroutine 



294 / 

295 / EXIT REQUEST (rROM TASK ",..Rea"> 

296 / 

297 00302 R 200463 R DAEX LAC (POOD /RETURN REQUEST MODE TO POOL 

298 00303 R 060417 R OAC» (RJ.) 

299 00304 R 200353 R LAC PH 

300 00305 R 060421 R OAC* (R2) 

301 00306 R 12.0464 R J!>1S« (NADD) 

302 00307 R 706561 A LPDI /OlSABt,E l,P ^^TERRUPTS 

303 00310 R 000363 R CAL OCPB /DISCONNECT INTERRUPT LIME 

304 00311 R 440356 R IS2 PDVTA /Ct-EAR ASSjGN INHIBIT FLAG IN POVL NODE 

305 00312 R 160356 R 02M* PDVTA 

306 00313 R 000423 R CAL (10) /E^jT 

307 / 

308 / REQUEST COMPLETED -- SET REQUESTOR'S EVENT VARIABLE TO +1 

309 / AND PICK NEXT REQUEST (I^ ANY) FROM C3UEUE. 

310 / 

311 00314 R 200454 R REOCMP LAC (*1> 

312 / 

^ 313 00315 R 060352 R SEV OAC* RE /SET REQUESTOR'S EV£WT VARIABLE 

I 314 00316 R 200455 R LAC ( 401000 )/DkCLARE A SIGNI^ICA^JT EvEfvT 

[^ 315 00317 R 705504 A ISA 

316 / 

317 00320 R 200463 R RNTP LAC (POOL) /RETURN REQUEST NODE TO POOL 

318 00321 R 060417 R DAC* (Rl) 

319 00322 R 200353 R LAC RN 

320 00323 R 060421 R OAC* (R2) 

321 00324 R 120464 R JMS» (NADD) 

322 / 

323 00325 R 600072 R JMP PQ /PICK AndThER REQUEST (JF Amy) 

324 / 

325 / INTERRUPT SERVICE ROUTINE 

326 / 

327 00326 R 000000 A INT /INTERRUPT ENTRY POINT 

328 00327 R 707762 A DBA /ENTER IKiDEX (PaGE) HODE 

329 00330 R 040343 R DAC ACBF /S^VE Ac 



PAGE 



LP. 6 



SRC 



CO 

I 

O 



330 


00331 


R 


706562 


A 




lprs 


331 


00332 


R 


040347 


R 




DAC 


332 


00333 


R 


706641 


A 




LPCS 


333 


00334 


R 


706621 


A 




IPQU 


334 


00335 


R 


200455 


R 




LAC 


335 


00336 


R 


705504 


A 




ISA 


336 


00337 


R 


200343 


R 




LAC 


337 


00340 


R 


703344 


A 




dbr 


338 


00341 


R 


620326 


R 




JMP« 


339 










/ 




340 


00342 


R 


000000 


A 


XAOJ 





341 


00343 


R 


000000 


A 


ACBF 





342 


00344 


R 


000000 


A 


CCBF 





343 


00345 


R 


000000 


A 


CABF 





344 


00346 


R 


000000 


A 


CWT 





345 


00347 


R 


000000 


A 


EV 





346 


00350 


R 


000000 


A 


HXl 





347 


00351 


R 


000000 


A 


HX2 





346 


00352 


R 


000000 


A 


RE 





349 


00353 


R 


000000 


A 


RN 





350 


00354 


R 


000000 


A 


TG 





351 










/ 




352 


00355 


R 


000000 


A 


PDVNA 





353 


00356 


R 


000000 


A 


PDVTA 





354 










/ 




355 


00357 


R 


000011 


A 


CCPB 


11 


356 


00360 


R 


000347 


R 




EV 


357 


00361 


R 


000016 


A 




16 


358 


00362 


R 


000326 


R 




INIT 


359 










/ 




360 


00363 


R 


000012 


A 


OCPB 


12 


361 


00364 


R 


000000 


A 







362 


00365 


R 


000016 


A 




16 


363 


00366 


R 


000326 


R 




INT 


364 










/ 




365 


00367 


R 


000013 


A 


MTCPB 


13 


366 


00370 


R 


000347 


R 




EV 


367 


00371 


R 


000012 


A 




12 


368 


00372 


R 


000001 


A 




1 



EV 



/READ STATUS AND SET IN EVENT VARIABLE 



/ClEAR STATUSi ERR FLAG, & DONE FLAG 
(401000)/'DtCUARE A SIGNIFICANT EVENT 
ACBF 
!NT 



/RESTORE AC 

/RETURN TO INTERRUPTED PROGRAH 



/XR ADJUST CONSTANT TO SUBTRACT PAGE 8ITS 

/AC BUFFER 

/CONTROL CHAR BufFeR (BITS 0^6} 

/INITIAL CURRENT ADDRESS BUFFER 

/COUNTER 

/EVENT VARIABLE 

/HEADER ADORESS 

/TEXT ADDRESS 

/ADDRESS 0^ REQUESTOR'S EVENT VARIABLE 

/ADDRESS Of REQUEST NODE PICKED FROM QUEUE 

/TRIGGER EVENT VARIABLE 

/PHYSICAL DEVICE NODE ADDRESS 

/ADDRESS 0*^ ADR 0^ TRIGGER EV IN PHY OEV NODE 

/CONNECT CPB 



/DISCONNECT CPB 



/MARK TIME CPB 



369 










/ 




370 


00373 


R 


000020 


A 


WFTCPB 


20 


371 


00374 


R 


000354 


R 




TC 


372 










/ 




373 


00375 


R 


000020 


A 


WFECPB 


20 


374 


00376 


R 


000347 


R 




EV 


375 










/ 




376 


00377 


R 


002700 


A 


TEMCPB 


2700 


377 


00400 


R 


000347 


R 




EV 


378 


00401 


R 


000003 


A 




3 


379 


00402 


R 


000002 


A 




2 


3B0 


00403 


R 


000404 


R 




ERRMr 


381 










/ 




382 


00404 


R 


004002 


A 


ERRMES 


00400 



0040!) R 000000 A 
00406 R 251245 A 
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00407 


R 


220230 


A 


00410 


R 


501011 


A 


00411 


R 


647650 


A 


00412 


R 


202450 


A 


00413 


R 


540610 


A 


00414 


R 


544320 


A 


00415 


R 


000000 


A 



/NAIT FOR TRIGGER CPB 

/WAIT FOR EVENT VARIABLE Cl=8 

/TYEP ERR MESSAGE 



ERRMES 004002} 000000f , ASCII "«•• LP NOT REA0Y"<15> 



383 / 

384 000002 R ,EMO START 



K3 



00416 
00417 
00420 
00421 
00422 
00423 
00424 
00425 
00426 
00427 
00430 
00431 
00432 
00433 
00434 
00435 
00436 
00437 
00440 
00441 
00442 
00445 
00444 
00445 
00446 
00447 
00450 
00451 
00452 
00453 
00454 
00455 
00456 
00457 
00460 
00461 
00462 
00463 
00464 
S 



R 0002 
R 0001 
R 0000 
R 0001 
R 0001 
R 0000 
R 0003 
R 0700 
R 0003 
R 0003 
R 0007 
R 0000 
R 0000 
0000 
0000 
0003 
0003 
R 1000 
R 0000 
R 7740 
R 0500 
R 0600 
R 1040 
1000 
0640 
0002 
0007 
R 0000 
R 0000 
R 0000 
R 0000 
R 
R 
R 
R 
R 
R 
R 
R 



52 
01 
27 
02 
23 
10 
54 
00 
37 



4010 
0037 
0000 
0000 
0000 
2000 
0002 

0001 



35 

34 

00 
40 
07 
IEE=00465 



24 

25 
27 
36 
25 
32 
11 
03 
00 
00 
00 
00 

00 
00 

03 
76 



13 
01 
00 
77 



•L 
•L 

*L, 
»L 



52 R "L 
77 A "L 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

A 

R 

A 

12 A »L 
01 R «L 

A 

A 

A 

A 

R 

A 

A 

A 

A 

A 



»L 
*L 
*L 
»L 
«L 

•L 

•L 

•L 
«L 
»L 






NO ERROR LINKS 



PAGE 



LP, 6 CROSS REFERENCE 





ACBF 


00343 


329 


336 


341» 








ALAD 


000325 


59* 


154 










ATTACH 


00123 


136 


150# 










8FM 


00206 


192 


194 


196 


201 


222» 




CAA 


000035 


64* 


266 










CABF 


30345 


265 


287 


343» 








CCBF 


00344 


222 


250 


342« 








CCPB 


00357 


88 


355» 










CNT 


00346 


227 


232 


240 


344« 






OAEX 


00302 


144 


297« 










DCPB 


00363 


303 


360« 










DETACH 


00132 


138 


161» 










OlAD 


000332 


60» 


165 










DQRQ 


000337 


61» 


122 










O.TG 


000010 


62« 


86 










crrmes 


00404 


380 


382« 










EV 


00347 


89 


269 


273 


331 


345« 


00 


HINF 


00141 


142 


172« 








U) 


HNAM 


00027 


80 


102* 








00 


HXl 


00350 


178 


181 


209 


223 


233 




HX2 


00351 


180 


189 


347» 








INT 


00326 


327# 


338 


358 


363 






UBF 


00000 


73* 


236 


248 


251 


253 




LFL 


00203 


206 


214* 










LPCD 


706621 


70** 


98 


333 








lpcs 


706641 


71» 


99 


332 








lpdi 


706561 


69* 


302 










LPEI 


706544 


68* 


270 










LPPM 


706521 


66» 


255 










LPPl 


706541 


65» 


208 


211 








LPRS 


706552 


67* 


330 










MTCPB 


00367 


285 


365« 










NADO 


000107 


55» 


301 


321 








PDVU 


000252 


58* 


78 










POVNA 


00355 


85 


120 


150 


161 


352« 




POVTA 


00356 


87 


93 


304 


305 


353* 




POOL 


000240 


57* 


297 


317 








PQ 


00072 


120* 


323 










PRINT 


00143 


140 


177« 









356 



346< 



366 



374 377 



U) 



PRNT 


00246 


207 


210 


254 


262» 


268 


290 


PR+JTEF 


00301 


263 


277 


283 


?93» 






PRNTXT 


00277 


276 


290« 










PRNTl 


00252 


266* 


268 










PRNT2 


00273 


279 


285« 










RE 


00352 


130 


151 


244 


313 


348# 




REC3CMP 


00314 


157 


168 


212 


3H« 






RN 


00353 


125 


152 


163 


299 


319 


349* 


RNTP 


00320 


257 


317» 










Rl 


000101 


53# 


79 


121 


151 


162 


298 


R2 


000102 


54* 


81 


153 


164 


300 


320 


SEV 


00315 


146 


156 


167 


173 


186 


313* 


SNAM 


000123 


56# 


82 










START 


00002 


78» 


106 


384 








TEMCPB 


00377 


280 


376* 










TQ 


00354 


92 


118 


350* 


371 







291 



318 



PAGE J.0 LP. 6 CROSS REFERENCE 



UBM 


00174 


186 


199 


206* 


WCA 


000034 


63* 


267 




wrccpB 


00375 


271 


281 


286 


WFTCPB 


00373 


114 


370«i 




WFTCR 


00070 


100 


114* 


124 


XAOJ 


00342 


96 


126 


340* 


X12 


000012 


51* 


235 


238 


Xl3 


000013 


52# 


237 


239 



373* 



8.6 ADDITIONAL INFORHATION 

Tasks Written in FORTRAN: 

The PAUSE statement results in the Task being SUSPENDed. The 

RESUME MCR Function is used to continue after a PAUSE. 

The STOP statement results in a Task EXIT. 

I/O requests to standard I/O Handlers (through LUN's) always wait 
until the I/O request has completed before continuing. 

OTS messages are output on LUN 4. 

OTS-2J2f is a FORTRAN READ or WRITE failure. 

Tasks Written in MACRO: 

The MACRO Assembler pseudo-op .CBD (Common Block Definition) allows 
the assembly language programmer to declare a COMMON of an indi- 
cated name and size, and to specify a word to be set to its base 
address . 

The .CBD pseudo-op takes a COMMON naune and its size as arguments, 
reserves one word of core, and outputs loader codes and parameters 
to direct the Task Builder to set a vector to the first element of 
the indicated COMMON in the reserved word. For example, the state- 
ment 

BASE .CBD ABCD 6 

will provide the base address of COMMON/ABCD/ in the word labeled 
BASE. (This feature will become available under DOS August 71.) 

Normally, 32 LUN's exist; however, this number can be changed by 
reassembling the system. On a cold start image, LUN 1 is assigned 
to DSK, LUN's 2, 3, and 4 are assigned to TTj2f, and all other LUN's 
are assigned to NONE. 
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APPENDIX A 
SYNTACTICAL DESCRIPTIONS OF MCR FUNCTIONS 



The following is a description of the MCR Functions provided. The 
syntax is defined in modified Backus Normal Form using the following 
conventions and definitions: 



< > = Angle brackets delimit metalinguistic variables 

" " = Quote marks delimit a. character string 

I = A vertical bar indicates alternation (OR) 
No operator indicates concatenation 

( ) = Parens indicate factoring 

$ = Indicates any number (including zero) of the 
following 

NUL = Indicates the empty set 

<BC> = Break character — blank or conrnia 

<CR> = Carriage Return 

<AM> = ALTMODE 

<NBC> = Non-break character 

<NTC> = Non-terminal character 

<DV> = Decimal value 



A. ENTER TIME 

SYNTAX = "ETI" $<NBC><BC><TIME> (<BC><DATE> |NUL) <CR> | <AM> 



<TIxME> = <HOURS>":"<MINUTES>":"<SECONDS> 
<DATE> = <MONTH>"/"<DAY>"/"<YEAR> 



B. TIME 

SYNTAX = "TIM" $<NTC> <CR> | <AM> 

C. DATE 

SYNTAX = "DAT" $<NTC> <CR> | <AM> 

D. TASK LIST 

SYNTAX = "TAS" $<NTC> <CR> | <AM> 

E. PARTITIONS 

SYNTAX = "PAR" $<NTC> <CR> | <AM> 

F. COMMON BLOCKS 

SYNTAX = "COM" $<NTC> <CR> | <AM> 
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G. DEVICES AND ASSIGNMENTS 

SYNTAX = "DEV" $<NTC> <CR> | <AM> 

H. INSTALL 

SYNTAX = "INS" $<NBC><BC><TASK NAME> 

(<BC><DEFAULT PRIORITY> | NUL) <CR> | <AM> 

<DEFAULT PRIORITY> = Decimal value of 1-512 

I . REMOVE 

SYNTAX = "REM" $<NTC> <CR> | <AM> 

J. REQUEST 

SYNTAX = "REQ" $<NBC><BC><TASK NAME> 

(<BC><RUN PRIORITY>|nUL) <CR> | <AM> 

<RUN PRIORITY> = Decimal value of 1-512 

K. SCHEDULE 

SYNTAX = "SCH" $<NBC><BC><TASK NAME><BC><TIME> 
{<BC><RESCHEDULE INTERVAL> | NUL) 
(<BC><RUN PRIORITy>) <CR> | <AM> 

<TIME> = <HOURS>" : "<MINUTES>" : "<SECONDS> 
<RESCHEDULE INTERVAL> = <DV> ("H" "M" "S" "T") 
<RUN PRIORITY> = Decimal value of 1-512 



RUN 



SYNTAX = "RUN" $<NBC><BC><TASK NAME ><BC>< SCHEDULE DELTA> 
(<BC>< RE SCHEDULE INTERVAL> | NULL) 
(<BC><RUN PRIORITY>iNUL) <CR> | <AM> 

<SCHEDULE DELTA> = <DV> ("H" | "M" | "S" | "T" ) 
<RESCHEDULE INTERVAL> = <DV> { "H" | "M" | "S" | "T" ) 
<RUN PRIORITY> = Decimal value of 1-512 



M. SYNC 



SYNTAX = "SYN" $<NBC><BC><TASK NAMEXBCXSYNC UNIT> 

<SCHEDULE DELTA> (<BC><RESCHEDULE INTERVAL> | NUL) 
(<BC><RUN PRIORITY>|nUL) <CR> | <AM> 

<SYNC UNIT> = "H"|"M" |"S"| "T" 
<SCHEDULE DELTA> = <DV> ("H" | "M" | "S" | "T" ) 
<RESCHEDULE INTERVAL> = <DV> ("H" | "M" | "S" | "T" ) 
<RUN PRIORITY> = Decimal value of 1-512 
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N . CANCEL 

SYNTAX = "CAN" $<NTC> <CR> | <AM> 

O. RESUME 

SYNTAX = "RES" $<NBC><BC><TASK NAJ4E> <CR> | <AM> 

P. FIX IN CORE 

SYNTAX = "FIX" $<NBC><BC><TASK NAI«> <CR> | <AM> 

Q. UNFIX 

SYNTAX = "UNF" $<NBC><BC><TASK NAME> <CR> | <AM> 

R. ENABLE 

SYNTAX = "ENA" $<NBC><BC><TASK NAME> <CR> | <AM> 

S. DISABLE 

SYNTAX = "DIS" $<NBC><BC><TASK NAME> <CR> | <AM> 

T. REASSIGN 

SYNTAX = "REA" $<NBC><BC><LUN><BC><NEW ASSIGNMENT> 
<BC><OLD ASSIGNMENT> <CR> | <AM> 

U. SAVE 

SYNTAX = "SAV" $<NTC> <CR> | <AM> 

V. OPEN REGISTER 

SYNTAX = "OPE" $<NBC><BC><NUMBER>{<BC> "D" (<UNIT> |nUL) | NUL) 
<CR> I <AM> 

<NUMBER> = <SIGN><RADIX><DIGIT>$<DIGIT> 
<SIGN> = "+"| "-" I NUL 
<RADIX> = "0"|"D"iNUL 
<DIGIT> = (i3|l|2|3i4|5|6|7) I (JZf|l|2|3|4|5|6|7|8|9) 

default: positive, octal. 
<UNIT> - Disk unit number - default: zero. 
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APPENDIX B 
MACRO EXPANSIONS FOR SYSTEM DIRECTIVES 



/ EDIT #6 
/ 

/ COPYRIGHT 1971, DIGITAL iGUlPHEMT CORp.i MaYNArOi HASS, 

/ 

/ RSX-15 MACRO DEFINITIONS 8 APR 71 H. KREJCI 

/ ABREVIATIOMS -^ U^iLESS OTHERWISE . SPECIFIED, ALL PARAMETERS 

/ EXCEPT ADDRESSES ARE GIVEN IN DECIHAL, 

/ 

/ RUFF CORE BUFFER ADDRESS 

/ CL INTERRUPT CONNECT LOCATION 

/ CTB CONTROL TABLE ADDRESS 

/ EV EVENT VARIABLE ADDRESS 

/ FLN!AM FILE NAME !l-6 CHARACTERS) 

/ LN PJTERRUPT LINE MIJMBER (OCTAL) 

/ im LOGICAL UNIT NUMBER 

/ Ml MARK TIME INTERVAL (A TICK ThRy a DAY) 

/ MODE DATA MODE INDICATOR 

/ m MARK TIME UNITS 

/ RA RESUMPTION ADDRESS 

/ m RESCHEDULE INTERVAL (K"! DAY, WHERE 

/ IMPLIES No RESCHEDULING) 

/ RP RU^' PRIORITY (K-512, WHERE » IMPLIES 

/ DEFAULT PRIORITY) 

/ RU RESCHEDULE UNlTS' (H,M,S,T> 

/ SO SCHEDULE DELTA (A TICK THRU A DAY) 

/ SH SCHEDULE HOURS (0'^23) 

/ SI?E CORE BUFFER SI2E (OCTAL) 

/ SH SCHFOULE MINUTES (0«59) 

/ SS SCHEDULE SECONDS (0't59S 

/ SU SCHEDULE DELTA UNITS (H,M,S.T> 

/ S^ SYNCHRONIZATION UNIT (H,M,S»T> 

/ TASNAM TASK NAME (1-6 CHARACTERS) 

/ EXT FILE NAME EXTENSION (1-^3 CHARACTERS) 

/ 

Ms4 /HOURS INDICATOR 

Ms3 /MINUTES INDICATOR 

Ss2 /SECONDS INDICATOR 

T=l /TICKS INDICATOR 

/ 

,INH=7?5522 /INTERRUPT INHIBIT lOT 

,EN8 = 7E!5521 /INTERRUPT ENABLE lOT 

/ 

HH=165 /HRS IN SCOH 

MMS164 /HIN IN SCOM 

SSS163 /SEC IN SCOfi 

M0»166 /HON IN SCOH 

0AS167 /DAY IN SCQM 

YR=170 /year in SCOM 

SAVE=13l /SAVE ENTRY POINT (IN SCOM) 

REST=134 /RESTORE ENTRY POINT (IN SCOM) 
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f = .) 



f 



f 
/ 



".» 



REQUEST TASNAME.RPt.EV]] 

.DEFIN REQUEST»TN,RP»-EV 

CAU ,*2 

JMP .+6 

01 

EV*0 

,S1XBT "Tj" 

0J ,LOC .,*2 

.DEC 

RP*0 

.ENOM 

SCHEDULE TASNAM,SH,SH,SSt.R]»RUC.RPtiEV]]3 

.DEFIN SCHEDULE. TN,SH,SM,SS,RI,RU«HpiEV 

CAL ,*Z 

JMP .♦IS 

02 

EV*0 

•SIXBT "TN" 

31 ,LOC .,*2 

.DEC 

SHJ Sf<J SS 

RI*0 

RU*0 

RP*0 

,ENOM 



RUN 



tasnah,so»suCirIiRUC,rp[,Ev:!jj 



.OEFIN RUN.TN.SO.SU.RI »RU»RP.EV 
CAL ,*2 
JMP ,*12 

33 

EV*0 

, SIXBT "TN" 

l?J .LOC .i + S 

,DEC 

SDl SU 

RI*0 

RU*0 

RP*0 

,ENDM 



SYNiC 



TASNAM,SH»SD,SuC»RI,RUE:,RPC»EV3]3 



, DEFIN SYNC,TN,SH#S0iSU»R1»RUiRPiEV 

CAL ,*2 

JMP ,*IZ 

14 

EV*0 

.SIXST "TN" 

3* ,LOC ,,♦2 

.DEC 

S2l S0» SU 
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RI+0 






RU*0 






RP + 






.ENpH 




/ 






/ »«»» 


CANCEL 


TASNiAHCEV] 


/ 








.DEF !N 


CAr^CELiTN.EV 




CAL 


.*2 




JMP 


,*5> 




04 






f:v*0 




f l = »! 


.SIXBT ' 


•T'J" 




^s ,L.nc 


.,+2 




.EMD^' 




/ 






f »»»» 


SUSPFND 




/ 







•DLFIM SUSPEND 
CAt (6) 

,f:ndh 
/ 

f »»»« RESUME TAS^iAMC,HAL,FV3] 

/ 

.DEFIN RESUME, TNiiRA.Ev 

CAL .+2 
JMP ,+6 

37 

EV*0 

, SIXBT "T'J" 



. ! - » ' 



/ 






.LOC .,*2 



RA*0 

,ENDM 

MARK 



Kl.MU.EV 



.DEFIN MARK,MI iMLl.EV 

CAU .+2 

JMP ,*5 

13 

EV 

.DECj mIj mu 

.EWOM 

WAITFOH EV 

.DEFIN WAITFOR,EV 

CAL .+2 

JMP .+3 

2% 

EV 



/ 



WAIT 

.DEFIN WAIT 
CAL (5) 
.ENDM 
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»»«» EXIT 

.OEFIN EXIT 
CAL (10) 
.ENDM 

• »»» CONNECT ln»clE#£:v3 

.OFF IN CONNECT, LN.CL.L'V 

CAL ,*?. 

JMP ,*5 

11 

EV*0 

LN 

CI 

,EMOM 

««»♦ DISCONNECT LNjCLCiEV] 

.DEFIN OISCON^iECT^L^»CLlEV 

CAL 

JMP 

12 

EV*0 

LH 

CL 

.ENDH 

»«»» READ 



.+2 



LUN,H00E.BUFF,SI?E!:,FV1 



.PEFIN READ»LUN,M0DE.BUFF,SI2E,EV 
CAL .+2 
JMP ,+7 

2600 
EV + 

.DEC* LUN} ,OCT 

MOOE 

BUFF 

SIZE 

,ENDM 



/ 


• »«* 


WRITE 


LU^i|M0DE,BUFFC,EV3 




•DEFIN 


WRITEiLUNiMOOE.BUPT.EV 






CAL 


.+2 






JMP 


.*(> 






2700 








EV*0 








.DECj luni ,oct 






MODE 








8UFF 








,ENDM 




/ 








/ 
/ 


*«»« 


OSKAL 


CTB[,EV3 




•DEFIN 


DSKALiCTB.EV 






CAL 


.♦2 
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JMP ,*5 

\3>m 

EV*0 

1 

CTB 

.ENOM 

»»»« OSKOAL CTBCEV] 

.DEFIN OSKQAL.CTBiEV 

CAL .*2 

JMP .+§ 

1600 

EV*0 

1 

CTB 

.ENDH 

»•»• DSKPUT CTBCiEV] 

.DEFIM DSKPUT, CTBiEV 

CAU .*2 

JMP ,+5 

3100 

EV*0 

1 

CTB 

,ENDM 

•»«• OSKGET CT8C.EV] 

.DEFIN DSKGET,CT8»EV 
CAL .*2 
JMP ,+5 

30550 
EV*0 
1 
CTB 

.ENDM 

•»»» ATTACH LUNC.EV] 

.DEFIN ATTACHiLUNiEV 

CAU .*2 

JMP ,*4 

?400 

EV*0 

.OECJ LUN! .OCT 

• ENOM 

»»«» DETACH LUNCiEV] 

.OEFJN DETACH, LUNiEV 

CAL .+S 

JMP ,*4 

2500 

EV + 
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f 



i'.J 



/ 



• s 



/ 



,DECl LUNiJ ,OGT 

,tNDM 

SEEK LUN,Fl,NAM,EXTt,EV3 

.DEFIN SEEK.LUN.FUNAH.EXTiEV 

CAL .♦S 

JMP ,+7 

3200 

EV*0 

.OEC» LUNJ .OCT 

.SIXBT "FLNAM" 

!?! .LOG ,.*2 

, SIXBT "EXT" 

,ENDM 

ENTER lUN.FLNAM.EXtE.EV] 

, DEFIN ENTER»LUNiFLNAMiEXT,EV 

CAL, .*2 

JMP ,+7 

3300 

EV*0 

.pEC! LUN! .OCT 

.SIXBT "FLMAM" 

0! ,LOC ,.*2 

, SIXBT "EXT" 

,£NDM 

DELETE LUNfFUNAH,EXTE,EV3 

.DEFIN DELETE. LUNiFLMAM, EXT. EV 

CAL .*2 

JMP .*7 

3500 

EV*0 

.OECj LUMi .OCT 



,.«.! 


.SIXBT ' 


"FLNAM" 




5?> .LOC 


.,*2 




.SIXBT ' 


"EXT" 




.EI^OM 




/ 








CLOSE 


LUNC.EV] 


.OEFIN 


CLOSE.LUN.EV 




CAL 


.♦2 




JMP 


.♦4 




3400 






EV*0 






.DECl LUN> .OCT 




.ENDM 




f 






f •»«» 


HINF 


LUN.EV 


/ 








.DEFIN 


HINF. LUN, EV 




CAL 


.♦2 




JMP 


.♦4 
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3600 






EV*0 






.OECj LUNl .OCT 




.EiNDH 




y 






/ ••»• 

/ 


DISABLE 


TASNAMC.Iva 


f 


.0EriN 


DISABLE, TNiEV 




CAL 


,*2 




JMP 


.*5 




21 






EV*0 




*«*ti 


.SIXBT 


"TN" 




01 .LOC 


.,*2 




• ENDM 




/ 






/ «»«• 


ENABLE 


TASNAMC,|V3 


/ 








•OEFIN 


ENABLEiTNiEV 




CAL 


.*2 




JMP 


.♦5 




22 






EV*0 




ii»ii 


.SIXST 


"TN" 




0» ,LOC 


,,♦2 




.ENDM 




/ 






/ **«» 


nx 


TASKNAMCEV] 


/ 








.OEFlN 


FIX.TN.EV 




CAL 


.♦2 




JMP 


.♦5 




15 






EV*0 




••"•J 


•SIXBT ' 


»TM» 




0J .LOC 


..*2 




.ENDM 




/ 






/ *»•• 


UNFIX 


TASNAMC.EV3 


/ 








.OEFIN 


UNFIX, TN.EV 




CAL 


.*2 




JMP 


.♦5 




16 






EV*0 




.••.* 


.SJXBT "TN'' 




01 .LOC 


..♦2 




.ENDH 




/ 






/ ••*• 


DECLARE 




/ 








.DCFIN 


DECLARE 




LAC 


(401000) 




ISA 






.ENDM 
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/ 


TIME 


HRS.MIN.SEC 


.OEFIN 


TIME, HRS.MIN, SEC 




.INH 






LAC» 


(HH) 




OAC 


HRS 




LAC» 


(MM) 




OAC 


MlN 




LAC« 


(SS) 




.ENB 






OAC 


SEC 




.ENOM 




/ 






f »««« 


DATE 


HRSiMlN, SEC, MONf DAY, YEAR 


/ 


.OEFIN 
,INH 


ATE. HRS,M IN, SEC, HON, DAY, YEAR 




LAC» 


(HH) 




OAC 


MRS 




LAC« 


(MM) 




OAC 


MIN 




LAG* 


(SS) 




OAC 


SEC 




LAC* 


(MO) 




nAC 


MQM 




LAC* 


<0A) 




lAC 


DiY 




LAC* 


(Y«) 




,ENB 






OAC 


YEAR 




.ENDM 




t 






/ 


IN7t■^'TF^Y CL 


,DEF1N 


INTESiTRY.CL 


cu 



DBA 






JMS* (SAVE) 




,REPT 20 

15 




NOP 






.EMDM 




/ 






/ «#0» 


lNTE.xn 


• CL 


/ 







.OEFIN IN!TEXIT,CL 

LAC (CD 

JMP* (REST) 
.ENO'^ 

.END 
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APPENDIX C 
CAL PARAflETER BLOCKS FOR SYSTEM DIRECTIVES 



QUEUE I/O DIRECTIVE 



Word — CAL Function Code (00) in bits 12-17 and 

I/O Function Code in bits 3-11 

Word 1 — Event Variable address 

Word 2 — Logical Unit Number (LUN) 

Word 3 — Unique to I/O Function 

Word 4 — Unique to I/O Function 

Word 5 — Unique to I/O Function 



REQUEST DIRECTIVE 

Word — CAL Function Code (01) 

Word 2 — Task name (first half) 
Word 3 — Task name (second half) 
Word 4 — Run priority (0-512) 

SCHEDULE DIRECTIVE 



Word 





-■ 


Word 


1 


-■ 


Word 


2 


— 


Word 


3 


— 


Word 


4 


— 


Word 


5 


— 


Word 


6 


— 


Word 


7 


— 


Word 


10 


— 


Word 


11 


- 



CAL Function Code (02) 

Event Variable address 

Task name (first half) 

Task name (second half) 

Schedule hour (0-23) 

Schedule minute (0-59) 

Schedule second (0-59) 

Reschedule interval (0-one day) 

Interval units (1-tks, 2-secs, 3-rains, 4-hrs) 

Run priority (0-512) 



RUN DIRECTIVE 



Word — CAL Function Code (03) 

Word 1 — Event Variable address 

Word 2 — Task name (first half) 

Word 3 — Task name (second half) 

Word 4 — Schedule delta (0-one day) 

Word 5 — Delta units (1-tks, 2-secs, 3-mins, 4-hrs) 

Word 6 — Reschedule interval (0-one day) 

Word 7 — Interval units (1-tks, 2-secs, 3-mins, 4-hrs) 

Word 10 — Run priority (0-512) 



SYNC DIRECTIVE 

Word — CAL Function Code (14) 

Word 1 — Event Variable address 

Word 2 — Task name (first half) 

Word 3 — Task name (second half) 

Word 4 — Sync units (1-tks, 2-secs, 3-mins, 4-hrs) 

Word 5 — Schedule delta from synchronization (0-one day) 
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Word 6 — Delta units (1-tks, 2-secs, 3-inins, 4-hrs) 
Word 7 — Reschedule interval (0-one day) 
Word 10 — Interval units (1-tks, 2-secs, 3-mins, 4-hrs) 
Word 11 — Run priority (0-512) 



CANCEL DIRECTIVE 

Word — CAL Function Code (04) 

Word 1 — Event Variable address 

Word 2 — Task name (first half) 

Word 3 — Task name (second half) 



M. 



SUSPEND DIRECTIVE 

Word — CAL Function Code (06) 

RESUME DIRECTIVE 

Word — CAL Function Code (07) 

Word 1 — Event Variable address 

Word 2 — Task name (first half) 

word 3 — Task name (second half) 

Word 4 — Resumption address 

WAIT DIRECTIVE 

Word — CAL Function Code (05) 

MARK DIRECTIVE 

Word — CAL Function Code (13) 

Word 1 — Event Variable address 

Word 2 — Delta time (0-one day) 

Word 3 — Delta units (1-tks, 2-secs, 3-rains, 4-hrs) 

WAITFOR DIRECTIVE 

Word — CAL Function Code (20) 
Word 1 — Event Variable address 

EXIT DIRECTIVE 

Word — CAL Function Code (10) 

CONNECT DIRECTIVE 

Word — CAL Function Code (11) 

Word 1 — Event Variable address 

Word 2 — Interrupt line number 

Word 3 — Interrupt transfer address 
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N. 



DISCONNECT DIRECTIVE 

Word — CAL Function Code (12) 

Word 1 — Event Variable address 

Word 2 — Interrupt line number 

Word 3 — Current interrupt transfer address 



FIX DIRECTIVE 

Word — CAL Function Code (15) 

Word 1 — Event Variable address 

Word 2 — Task name (first half) 

Word 3 — Task name (second half) 



UNFIX DIRECTIVE 

Word — CAL Function Code (16) 

Word 1 — Event Variable address 

Word 2 — Task name (first half) 

Word 3 — Task name (second half) 



DISABLE DIRECTIVE 

Word — CAL Function Code (21) 

Word 1 — Event Variable address 

word 2 — Task name (first half) 

Word 3 — Task name (second half) 



R. 



ENABLE DIRECTIVE 



Word — CAL Function Code (22) 

Word 1 — Event Variable address 

Word 2 — Task name (first half) 

Word 3 — Task name (second half) 
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APPENDIX D 
SUWARY OF RETURNED EVENT VARIABLES 



EVENT VARIABLE CONVENTIONS 



The following conventions apply to Event Variables in Tasks by the 
System. 

1. Positive values signal successful completion 

2. Zero indicates a request is still pending 

3. Negative values indicate rejection or unsuccessful 
completion. 

-5 Illegal header word read from device (data mode in- 
correct or data validity bits improperly set) (DVH) 

-6 Unimplemented or illegal Function (DVH) 

-7 Illegal data mode (DVH) 

-10 File still open (DVH) 

-11 File not open (DVH) 

-12 DECtape error (DVH) 

-13 File not found (DVH) 

-14 Directory full (DVH) 

-15 Medi\m full (DVH) 

-16 Output word-pair-count or input-buffer-size error (DVH) 

-23 Input word-pair-count error (DVH) 

-24 LUN has been REASSIGNed while an ATTACH or DETACH 
request was in an I/O request queue (DVH) 

-1^1 Out of range Logical Unit Number (10.) 

-102 Un-assigned Logical Unit Number (10.) 

-103 Non-resident Device Handler (10. ) 

-lj2(4 Control Table argument error (DVH) 

-201 Task not in system (RQ. , SC, RN., SY., DA., EA. , EX., 

UF . , CN . ) 

-202 Task is active (RQ., FX.) or not active (RS.) 

-203 CAL not Task issued (SC. , RN. , SY. , MT. ) 

-204 Task is DISABLED (RQ., SC, RN., SY. , FX.) 

-205 Task not suspended (RS.) 

-207 Task already FIXed (FX.) or not FIXed (UF.) 

-210 Partition occupied (FX.) 

-301 Line number rejected (CI., DI.) 

-302 Line is CONNECTed (CI.) or not CONNECTed (DI.) 

-777 Pool is empty 

DVH — Device Handler 

10. — 'QUEUE I/O' Directive 

RQ. — 'REQUEST' Directive 

SC. — 'SCHEDULE' Directive 

RN. — 'RUN' Directive 

SY. — 'SYNC Directive 

CN. — 'CANCEL' Directive 

RS. — 'RESUME' Directive 

CI. — 'CONNECT' Directive 

DI. ~ 'DISCONNECT' Directive 
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FX. — 'FIX IN CORE' Directive 

UF. — 'UNFIX' Directive 

DA. — 'DISABLE' Directive 

EA. — 'ENABLE' Directive 

MT- ~ 'MARK' Directive 
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APPENDIX E 
REGISTERS SAVED DURING "SAVE" AND "RESTORE" OPERATIONS 



Word 





— 


AC buffer 


Word 


1 


— 


XR buffer 


Word 


2 


— 


LR buffer 


Word 


3 


— 


MQ buffer 


Word 


4 


— 


SC buffer 


Word 


5 


— 


Rl buffer 


Word 


6 


— 


R2 buffer 


Word 


7 


— 


R3 buffer 


Word 


10 


— 


R4 buffer 


Word 


11 


— 


R5 buffer 


Word 


12 


— 


R6 buffer 


Word 


13 


— 


XIO buffer 


Word 


14 


— 


Xll buffer 


Word 


15 


— 


X12 buffer 


Word 


16 


— 


XI 3 buffer 


Word 


17 


— 


L20 buffer 



(accumulator) 
(index register) 
(limit register) 
(multiplier-quotient register) 
(step counter) 
(absolute location 101) 
(absolute location 102) 
(absolute location 103) 
(absolute location 104) 
(absolute location 105) 
(absolute location 106) 
(autoincrement register 10) 
(autoincrement register 11) 
(autoincrement register 12) 
(autoincrement register 13) 
(location 20 - CAL return) 
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SCALES OF NOTATION 



APPENDIX F 



CONVERSION TABLES 



2 IN DECIMAL 



X 




2' 




X 


2- 


X 




2- 




0.001 


1.00069 


33874 


62581 


0.01 


1.00695 55500 56719 


0.1 


1.07177 


34625 


36293 


0.002 


1.00138 


72557 


11335 


0.02 


1.01395 94797 90029 


0.2 


1.14869 


83549 


97035 


0.003 


1.00208 


16050 


79633 


0.03 


1.02101 21257 07193 


0.3 


1.23114 


44133 


44916 


004 


1.00277 


64359 


01078 


0.04 


1.02811 38266 56067 


0.4 


1.31950 


79107 


72894 


0.005 


1.00347 


17485 


09503 


0.05 


1.03526 49238 41377 


0.5 


1.41421 


35623 


73095 


0.006 


1.00416 


75432 


38973 


0.06 


1.04246 57608 41121 


0.6 


1.51571 


65665 


103S8 


0.007 


1.00486 


38204 


23785 


0.07 


1.04971 66836 23067 


0.7 


1.62450 


47927 


12471 


0.008 


1.00556 


05803 


98468 


0.08 


1.05701 80405 61380 


0.8 


1.74110 


11265 


92248 


0.009 


1.00625 


78234 


97782 


0.09 


1.06437 01824 53360 


0.9 


1.86606 


59830 


73615 










10*" IN OCTAL 











10" 





1 

12 

144 

1 750 

23 420 




1 
2 
3 

4 


3 

46 

575 

346 


303 240 
641 100 
113 200 
360 400 
545 000 


5 
6 
7 
8 
9 



10' 

1.000 000 000 000 000 000 00 

0.063 146 314 631 463 146 31 

0.005 075 341 217 270 243 66 

0.000 406 HI 564 570 651 77 

0.000 032 155 613 530 704 15 

0.000 002 476 132 610 706 64 

0.000 000 206 157 364 055 37 

0.000 000 015 327 745 152 75 

0.000 000 001 257 143 561 06 

0.000 000 000 104 560 276 41 



10" n 

112 402 762 000 10 

1 351 035 564 000 11 

16 432 451 210 000 12 

221 411 634 520 000 13 

2 657 142 036 440 000 14 

34 327 724 461 500 000 15 

434 157 115 760 200 000 16 

5 432 127 413 542 400 000 17 

67 405 553 164 731 000 000 18 



10" 

0.000 000 000 006 676 337 66 

0.000 000 000 000 537 657 77 

0.000 000 000 000 043 136 32 

0.000 000 000 000 003 411 35 

0.000 000 000 000 000 264 11 

0.000 COO 000 000 000 022 01 

0.000 000 000 000 000 OOl 63 

0.000 000 000 000 000 000 14 

0.000 000 000 000 000 000 01 



n logic 2 

0.30102 99957 
0.60205 99913 
0.90308 99870 
1.20411 99827 
1.50514 99783 



log,Q2, 



109 2 



10 IN DECIMAL 



n log2 10 

3.32192 80949 
6.64385 61898 
9.96578 42847 
13.28771 23795 
16.60964 04744 



n logio 2 



n iog2 10 



6 


1.80617 


99740 


19.93156 


85693 


7 


2.10720 


99696 


23.25349 


66642 


S 


2.40823 


99653 


26.57542 


47591 


9 


2.70926 


99610 


29.89735 


28540 





3.01029 


99566 


33.21928 


09489 



ADDITION AND MULTIPLICATION TABLES 
Addition Multiplication 



0+1 



+ = 

: l4-0 = 

1 + 1 = 



Binary Scale 



Octal Scale 



0X0 = 

0X1=1X0=0 

1X1 = 1 






01 


02 


03 


04 


05 


06 


07 


1 


02 


03 


04 


05 


06 


07 


10 


2 


03 


04 


05 


06 


07 


10 


11 


3 


04 


05 


06 


07 


10 


11 


12 


4 


05 


06 


07 


10 


11 


12 


13 


5 


06 


07 


10 


11 


12 


13 


14 


6 


07 


10 


11 


12 


13 


14 


15 


7 


10 


11 


12 


13 


14 


15 


16 



1 


02 


03 


04 


05 


06 


07 


2 


04 


06 


10 


12 


14 


16 


3 


06 


11 


14 


17 


22 


25 


4 


10 


14 


20 


24 


30 


34 


5 


12 


17 


24 


31 


36 


43 


6 


14 


22 


30 


36 


44 


52 


7 


16 


25 


34 


43 


52 


61 



MATHEMATICAL CONSTANTS IN OCTAL SCALE 



TT = 341037 552421. 

TT-i = 0.24276 301556i 

Vl?= 1.61337 611067, 

In IT = 1.11206 404435, 

logi ;: = 1.51544 163223, 

VTO = 3.12305 407267, 



e = 2.55760 521305, 

e-i = 0.27426 530661, 

Ve'= 1.51411 230704, 

logioe = 0.33626 754251, 

logi e = 1.34252 166245, 

log. 10 = 3.24464 741136, 



7 = 


0.44742 


147707, 


In 7 = 


- 0.43127 


233602, 


log! Y = 


- .0.62573 


030645, 


V2 = 


1.32404 


746320, 


In2 = 


0.54271 


027760, 


In 10 = 


2.23273 


067355, 
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POWERS OF TWO 



n -n 

2 n 2 

1 1.0 

2 1 0.5 
4 2 0.25 
8 3 0.125 

16 4 0.062 5 

32 5 0.031 25 

64 6 0.015 625 

128 7 0.007 312 5 

256 8 0.003 906 25 

512 9 0.001 953 125 

1 024 10 0.000 976 562 5 

2 048 11 0.000 488 281 25 
4 096 12 0.000 244 140 625 

8 192 13 0.000 122 070 312 5 

16 384 14 0.000 061 035 156 25 

32 768 15 0.000 030 517 578 125 

65 536 16 0.000 015 258 789 062 5 

131 072 17 0.000 007 629 394 531 25 

262 144 18 0.000 003 814 697 265 625 

524 288 19 0.000 001 907 348 632 812 5 

1 048 576 20 0.000 OOO 953 674 316 406 25 

2 097 152 21 0.000 000 476 837 158 203 125 

4 194 304 22 0.000 000 238 418 579 101 562 5 

8 388 608 23 0.000 000 119 209 289 550 781 25 

16 777 216 24 0.000 000 059 604 644 775 390 625 

33 554 432 25 0.000 000 029 802 322 387 695 312 5 

67 108 864 26 0.000 000 014 901 161 193 847 656 25 

134 217 728 27 0.000 000 007 450 580 596 923 828 125 

268 435 456 28 0.000 000 003 725 290 298 461 914 062 5 

536 870 912 29 0.000 000 001 862 645 149 230 957 031 25 

1 073 741 824 30 0.000 000 000 931 322 574 615 478 515 625 

2 147 483 648 31 0.000 000 000 465 661 287 307 739 257 812 5 
4 294 967 296 32 0.000 000 000 232 830 643 653 869 628 906 25 
8 589 934 592 33 0.000 000 000 116 415 321 826 934 814 453 125 

17 179 869 184 34 0.000 000 000 058 207 660 913 467 407 226 562 5 

34 359 738 368 35 0.000 000 000 029 103 830 456 733 703 613 281 25 

68 719 476 736 36 0.000 000 000 014 551 915 228 366 851 806 640 625 

137 438 953 472 37 0.000 000 000 007 275 957 614 183 425 903 320 312 5 

274 877 906 944 38 0.000 000 000 003 637 978 807 091 712 951 660 156 25 

549 755 813 888 39 0.000 000 000 001 818 989 403 545 856 475 830 078 125 

1 099 511 627 776 40 0.000 000 000 000 909 494 701 772 928 237 915 039 062 5 

2 199 023 255 552 41 0.000 000 000 000 454 747 350 886 464 118 957 519 531 25 
4 398 046 511 104 42 0.000 000 000 000 227 373 675 443 232 059 478 759 765 625 

8 796 093 022 208 43 000 000 000 000 113 686 837 721 616 029 739 379 882 812 5 

17 592 186 044 416 44 0.000 000 000 000 056 843 418 860 808 014 869 689 941 406 25 

35 184 372 088 832 45 0.000 000 000 000 028 421 709 430 404 007 434 844 970 703 125 

70 368 744 177 664 46 000 000 000 000 014 210 854 715 202 003 717 422 485 351 562 5 

140 737 488 355 328 47 0,000 000 000 000 607 105 427 357 601001858 711242 675 78125 

281 474 976 710 656 48 0.000 000 000 000 003 552 713 678 800 500 929 355 621 337 890 625 

562 949 953 421 312 49 0.000 000 000 000 001 776 356 839 400 250 464 677 810 668 945 312 5 

1 125 899 906 842 624 50 0.000 000 000 000 000 888 178 419 700 125 232 338 905 334 472 656 25 

2 251 799 813 685 248 51 0.000 000 000 000 000 444 089 209 850 062 616 169 452 667 236 328 125 

4 503 599 627 370 496 52 0.000 000 000 000 000 222 044 604 925 031 308 084 726 333 618 164 062 5 

9 007 199 254 740 992 53 0.000 000 000 000 000 111 022 302 462 515 654 042 363 166 809 082 031 25 

18 014 398 509 481 984 54 0.000 000 000 000 000 055 511 151 231 257 827 021 181 583 404 541 015 625 

36 028 797 018 963 968 55 O.OOO 000 000 000 000 027 755 575 615 628 913 510 590 791 702 270 5u7 812 5 

72 057 594 037 927 936 56 0.000 000 000 000 000 013 877 787 807 814 456 755 295 395 851 135 253 906 25 

144 115 188 075 855 872 57 0.000 000 000 000 000 006 938 893 903 907 228 377 647 697 925 567 626 953 125 

288 230 376 151 711 744 58 0.000 000 000 000 000 003 469 446 951 953 614 188 823 848 962 783 813 476 562 5 

576 460 752 303 423 488 59 0.000 000 000 000 000 001 734 723 475 976 807 094 411 924 481 391 906 738 281 25 

1 152 921 504 606 846 976 60 0.000 000 000 000 000 000 867 361 737 988 403 547 205 962 240 695 953 369 140 625 

2 305 843 009 213 693 952 61 0.000 000 000 000 000 000 433 680 868 994 201 773 602 981 120 347 976 684 570 312 5 
4 611 686 018 427 387 904 62 0.000 000 000 000 000 000 216 840 434 497 100 886 801 490 560 173 988 342 285 156 25 
9 223 372 036 854 775 808 63 0.000 000 000 000 000 000 108 420 217 248 550 443 400 745 280 086 994 171 142 578 125 

18 446 744 073 709 551 616 64 0.000 000 000 000 000 000 054 210 108 624 275 221 700 372 640 043 497 085 571 289 062 5 

36 893 488 147 419 103 232 65 0.000 000 000 000 000 000 027 105 054 312 137 610 850 186 320 021 748 542 785 644 531 25 

73 786 976 294 838 206 464 66 0.000 000 000 000 000 000 013 552 527 156 068 805 425 093 160 010 874 271 392 822 265 625 

147 573 952 589 676 412 928 67 0.000 000 000 000 000 000 006 776 263 578 034 402 712 546 580 005 437 135 696 411 132 812 5 

295 147 905 179 352 825 856 68 000 000 000 000 000 000 003 388 131 789 017 201 356 273 290 002 718 567 848 205 566 406 25 

590 295 810 358 705 651 712 69 0.000 000 000 000 000 000 001 694 065 894 508 600 678 136 645 001 359 283 924 102 783 203 125 

1 180 591 620 717 411 303 424 70 0.000 000 000 000 000 000 000 847 032 947 254 300 339 068 322 500 679 641 962 051 391 601 562 5 

2 361 183 241 434 822 606 848 71 0.000 000 000 000 000 000 000 423 516 473 627 150 169 534 161 250 339 820 981 025 695 800 781 25 
4 722 366 482 869 645 213 696 72 0,000 000 000 000 000 000 000 211 758 236 813 575 084 767 080 625 169 910 490 512 847 900 390 625 
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OCTAL-DECIMAL INTEGER CONVERSION TABLE 



0000 

«a 
0777 

fOctol) 



Octal 

10000 

20000 

30000' 

40000 

50000 

60000 

70000 



0000 

to 

0511 

(Dicimel) 



Decimal 
4096 
8192 
12288 
16384 
20480 
24576 
28672 








1 


2 


3 


4 


5 


6 7 


0000 


0000 


0001 


0002 


OOOJS 


0004 


0005 


0006 0007 


0010 


0008 


0009 


0010 


0011 


0012 


0013 


0014 0015 


0020 


0016 


0017 


0018 


0019 


0020 


0021 


0022 0023 


0030 


0024 


0025 


0026 


0027 


0028 


0029 


0030 0031 


0040 


0032 


0033 


0034 


0035 


0036 


0037 


0038 0039 


0050 


0040 


0041 


0042 


0043 


0044 


0045 


0046 0047 


0060 


0048 


0049 


0050 


0051 


0052 


0053 


0054 0055 


0070 


0056 


0057 


0058 


0059 


0060 


0061 


0062 0063 


0100 


0064 


0065 


0066 


0067 


0068 


0069 


0070 0071 


0110 


0072 


0073 


0074 


0075 


0076 


0077 


0078 0079 


0120 


0080 


0081 


0082 


0083 


0084 


0085 


0086 0087 


0130 


0088 


0089 


0090 


0091 


0092 


0093 


0094 0095 


0140 


0095 


0097 


0098 


0099 


0100 


0101 


0102 0103 


0150 


0104 


0105 


0106 


0107 


0108 


0109 


QUO 0111 


0160 


0112 


0113 


0114 


0115 


0116 


0117 


0118 0119 


0170 


0120 


0121 


0122 


0123 


0124 


0125 


0126 0127 


0200 


0128 


0129 


0130 


0131 


0132 


0133 


0134 0135 


0210 


0136 


0137 


0138 


0139 


0140 


0141 


0142 0143 


0220 


0144 


0145 


0146 


0147 


0148 


0149 


0150 0151 


0230 


0152 


0153 


0154 


0155 


0156 


0157 


0158 0159 


0240 


0160 


0161 


0162 


0163 


0164 


0165 


0166 0167 


0250 


0168 


0169 


0170 


0171 


0172 


0173. 


0174 0175 


0260 


0176 


0177 


0178 


0179 


0180 


0181 


0182 0183 


0270 


0184 


0185 


0186 


0187 


0188 


0189 


0190 0191 


0300 


0192 


0193 


0194 


0195 


0196 


0197 


0198 0199 


0310 


0200 


0201 


0202 


0203 


0204 


0205 


0206 0207 


032d 


0208 


0209 


0210 


0211 


0212 


0213 


0214 0215 


0330 


0216 


0217 


0218 


0219 


0220 


0221 


0222 0223 


0340 


0224 


0225 


0226 


0227 


0228 


0229 


0230 0231 


0350 


0232 


0233 


0234 


0235 


0236 


0237 


0238 0239 


0360 


0240 


0241 


0242 


0243 


0244 


0245 


0246 0247 


0370 


0248 


0249 


0250 


0251 


0252 


0253 


0254 0255 








1 


2 


3 


4 


5 


6 


7 


0400 


0256 


0257 


0258 


0259 


0260 


0261 


0262 


02S3 


0410 


0264 


0265 


0266 


0267 


0268 


0269 


0270 


0271 


0420 


0272 


0273 


0274 


0275 


0276 


0277 


0278 


0279 


0430 


0280 


0281 


0282 


0283 


0284 


0285 


0286 


0287 


0440 


0288 


0289 


0290 


0291 


0292 


0293 


0294 


0295 


O450 


0296 


0297 


0298 


0299 


0300 


0301 


0302 


0303 


0460 


0304 


0305 


0306 


0307 


0308 


0309 


0310 


0311 


0470 


0312 


0313 


0314 


0315 


0316 


0317 


0318 


0319 


0500 


0320 


0321 


0322 


0323 


0324 


0325 


0326 


0327 


0510 


0328 


0329 


0330 


0331 


0332 


0333 


0334 


0335 


0520 


0336 


0337 


0338 


0339 


0340 


0341 


0342 


0343 


0530 


0344 


0345 


0346 


0347 


0348 


0349 


0350 


0351 


0540 


0352 


0353 


0354 


0355 


0356 


0357 


0358 


0359 


0550 


0360 


0361 


0362 


0363 


0364 


0365 


0366 


0367 


0560 


0368 


0369 


0370 


0371 


0372 


0373 


0374 


0375 


0570 


0376 


0377 


0378 


0379 


0380 


0381 


0362 


0383 


0600 


0384 


0385 


0386 


0387 


0388 


0389 


0390 


0391 


0610 


0392 


0393 


0394 


0395 


0396 


0397 


0398 


0399 


0620 


0400 


0401 


0402 


0403 


0404 


0405 


0406 


0407 


0630 


0408 


0409 


0410 


0411 


0412 


0413 


0414 


0415 


0640 


0416 


0417 


0418 


0419 


0420 


0421 


0422 


0423 


0650 


0424 


0425 


0426 


0427 


0428 


0429 


0430 


0431 


0660 


0432 


0433 


0434 


0435 


0436 


0437 


0438 


0439 


0670 


0440 


0441 


0442 


0443 


0444 


0445 


0446 


0447 


0700 


0448 


0449 


0450 


0451 


0452 


0453 


0454 


0455 


0710 


0456 


0457 


0458 


0459 


0460 


0461 


0462 


0463 


0720 


0464 


0465 


0466 


0467 


0468 


0469 


0470 


0471 


0730 


0472 


0473 


0474 


0475 


0476 


0477 


0478 


M79.. 


0740 


0480 


0481 


0482 


0483 


0484 


0485 


0486 


0487 


0750 


0488 


0489 


0490 


0491 


0492 


0493 


0494 


0495 


0760 


0496 


0497 


0498 


0499 


0500 


0501 


0502 


0503 


0770 


0504 


0505 


0506 


0507 


0508 


0509 


0510 


0511 



lOOO 


0512 


to 


le 


1777 


1023 


(Octal) 


(Decimal) 








1 


2 


3 


4 


5 


6 


7 


1000 


0512 


0513 


0514 


0515 


0516 


0517 


0518 


0519 


1010 


0520 


0521 


0522 


0523 


0524 


0525 


0526 


0527 


1020 


0528 


0529 


0530 


0531 


0532 


0533 


0534 


0535 


1030 


0536 


0537 


0538 


0539 


0540 


0541 


P542 


0543 


1040 


0544 


0545 


0546 


0547 


0548 


0549 


0550 


0551 


1050 


0552 


0553 


0554 


0555 


0556 


0557 


0558 


0559 


1060 


0560 


0561 


0562 


0563 


0564 


0565 


0566 


0567 


1070 


0568 


0569 


0570 


0571 


0572 


0573 


0574 


0575 


1100 


0576 


0577 


0578 


0579 


0580 


0581 


0582 


0583 


1110 


0584 


0585 


0586 


0587 


0588 


0589 


0590 


0591 


1120 


0592 


0593 


0594 


0595 


0596 


0597 


0598 


0599 


1130 


0600 


0601 


0602 


0603 


0604 


0605 


0606 


0607 


1140 


0608 


0609 


0610 


0611 


0612 


0613 


0614 


0615 


1150 


0615 


0617 


0618 


0619 


0620 


0621 


0622 


0623 


1160 


0624 


0625 


0626 


0627 


0628 


0629 


0630 


0631 


1170 


0632 


0633 


0634 


0635 


0636 


0637 


0638 


0639 


1200 


0640 


0641 


0642 


0643 


0644 


0645 


0646 


0647 


1210 


0648 


0649 


0650 


0651 


0652 


0653 


0654 


0655 


1220 


0656 


0657 


0658 


0659 


0660 


0661 


0662 


0663 


1230 


0664 


0665 


0666 


0667 


0668 


0669 


0670 


0671 


1240 


0672 


0673 


0674 


0675 


0676 


0677 


0678 


0679 


1250 


0680 


068 1 


0682 


0683 


0684 


0685 


0686 


0687 


1260 


0688 


0689 


0690 


0691 


0692 


0693 


0694 


0695 


1270 


0696 


0697 


0698 


0699 


0700 


0701 


0702 


0703 


1300 


0704 


0705 


0706 


6707 


0708 


0709 


0710 


0711 


1310 


0712 


0713 


0714 


0715 


0716 


0717 


0718 


0719 


1320 


0720 


0721 


0722 


0723 


0724 


0725 


0726 


0727 


1330 


0728 


0729 


0730 


0731 


0732 


0733 


0734 


0735 


1340 


0736 


0737 


0738 


0739 


0740 


0741 


0742 


0743 


1350 


0744 


0745 


0746 


0747 


0748 


0749 


0750 


0751 


1360 


0752 


0753 


0754 


0755 


0756 


0757 


0758 


0759 


1370 


0760 


0761 


0762 


0763 


0764 


0765 


0766 


0767 








1 


2 


3 


4 


5 


6 7 


1400 


0768 


0769 


077P 


0771 


0772 


0773 


0774 0775 


1410 


0776 


0777 


0774 


0779 


0780 


0781 


0782 0783 


1420 


0784 


0785 


0786 


0787 


0788 


0789 


0790 0791 


1430 


0792 


0793 


0794 


0795 


0796 


0797 


0798 0799 


1440 


0800 


0801 


0802 


0803 


0S04 


0805 


0806 0807 


1450 


0808 


0809 


0810 


0811 


0812 


0813 


0814 0815 


1460 


0816 


0817 


0818 


0819 


0820 


0821 


0822 0823 


1470 


0824 


0825 


0826 


0827 


0828 


0829 


0630 0831 


1500 


0832 


0833 


0834 


0835 


0836 


0837 


0838 0839 


1510 


0840 


0841 


0842 


0843 


0844 


0845 


0846 0847 


1520 


0848 


0849 


0850 


0851 


0852 


0853 


0854 0855 


1530 


0856 


0857 


0858 


0859 


0860 


0861 


0862 0863 


1540 


0864 


0865 


0866 


0867 


0868 


0869 


0870 0871 


1550 


0872 


0873 


0874 


0875 


0876 


0877 


0878 0879 


1560 


0880 


0881 


0882 


0883 


0884 


0885 


0886 0887 


1570 


0888 


0889 


0890 


0891 


0892 


0893 


0894 0895 


1600 


0896 


0897 


0898 


0899 


0900 


0901 


0902 0903 


1610 


0904 


0905 


0906 


0907 


0908 


0909 


0910 0911 


1620 


0912 


0913 


0914 


0915 


0916 


0917 


0918 0919 


1630 


0920 


0921 


0922 


0923 


0924 


0925 


0926 0927 


1640 


0928 


0929 


0930 


0931 


0932 


0933 


0934 0935 


1650 


0936 


0937 


0938 


0939 


0940 


0941 


0942 0943 


1660 


0944 


0945 


0946 


0947 


0948 


0949 


0950 0951 


1670 i 0952 


0953 


0954 


0955 


0956 


0957 


0958 0959 


1700 


0960 


0961 


0962 


0963 


0964 


0965 


0966 0967 


1710 


0968 


0969 


0970 


0971 


0972 


0973 


0974 0975 


1720 


0976 


0977 


0978 


0979 


0980 


0981 


0982 0983 


1730 


0984 


0985 


0986 


0987 


0988 


0989 


0990 0991 


1740 


0992 


0993 


0994 


0995 


0996 


0997 


0998 0999 


1750 


1000 


1001 


1002 


1003 


1004 


1005 


1006 1007 


1760 


1008 


1009 


1010 


1011 


1012 


1013 


1014 1015 


1770 


1016 


1017 


1016 


1019 


1020 


1021 


1022 1023 



F-3 



OCTAL-DECIMAL INTEGER CONVERSION TABLE (continued) 








1 


2 


3 


4 


5 


6 


7 


2000 


1024 


1025 


1026 


1027 


1028 


1029 


1030 


1031 


2010 


1032 


1033 


1034 


1035 


1036 


1037 


1038 


1039 


2020 


1040 


1041 


1042 


1043 


1044 


1045 


1046 


1047 


2030 


1048 


1049 


1050 


1051 


1052 


1033 


1054 


1055 


2040 


1056 


1057 


1058 


1059 


1060 


1061 


1062 


1063 


2050 


1064 


1065 


1066 


1067 


1068 


1069 


1070 


1071 


2060 


1072 


1073 


1074 


1075 


1076 


1077 


1078 


1079 


2070 


1080 


1081 


1082 


1083 


1084 


1085 


1086 


1087 


2100 


108S 


1089 


1090 


1091 


1092 


1093 


1094 


1095 


2iiO 


1096 


1097 


1096 


1099 


liOO 


ilOl 


1102 


1103 


2120 


1104 


1105 


1106 


1107 


1108 


1109 


1110 


1111 


2130 


1112 


1113 


1114 


1115 


1116 


1117 


1118 


1119 


2140 


1120 


1121 


1122 


1123 


1124 


1125 


1126 


1127 


2130 


1128 


1129 


1130 


1131 


1132 


1133 


1134 


1135 


2160 


1136 


1137 


1138 


1139 


1140 


1141 


1142 


1143 


2170 


1144 


1145 


1146 


1147 


1148 


1149 


1150 


USl 


2200 


11S2 


1153 


1154 


1155 


1156 


1157 


1158 


1159 


2210 


1160 


1161 


1162 


1163 


1164 


1165 


1166 


1167 


2220 


1168 


1169 


1170 


1171 


1172 


1173 


1174 


1175 


2230 


1176 


1177 


1178 


1179 


1180 


1181 


1182 


1183 


2240 


1184 


1185 


1186 


1187 


1188 


1189 


1190 


1191 


22S0 


1192 


1193 


1194 


1195 


1196 


1197 


1198 


1199 


2260 


1200 


1201 


1202 


1203 


1204 


1205 


1206 


1207 


2270 


1208 


1209 


1210 


1211 


1212 


1213 


1214 


1215 


2300 


1216 


1217 


1218 


1219 


1220 


1221 


1222 


1223 


2310 


1224 


1225 


1226 


1227 


1228 


1229 


1230 


1231 


2320 


1232 


1233 


1234 


1235 


1236 


1237 


1238 


1239 


2330 


1240 


1241 


1242 


1243 


1244 


1245 


1246 


1247 


2340 


1248 


1249 


1250 


1251 


1252 


1253 


1254 


1255 


2350 


1256 


1257 


1258 


1259 


1260 


1261 


1262 


1263 


2360 


1264 


1265 


1266 


1267 


1268 


1269 


1270 


1271 


2370 


1272 


1273 


1274 


1275 


1276 


1277 


1278 


1279 








1 


2 


3 


4 


5 


6 7 


2400 


1280 


1281 


1282 


1283 


1284 


1285 


1286 1287 


2410 


1288 


1289 


1290 


1291 


1292 


1293 


1294 1295 


2420 


1296 


1297 


1298 


1299 


1300 


1301 


1302 1303 


2430 


1304 


1305 


1306 


1307 


1308 


1309 


1310 1311 


2440 


1312 


1313 


1314 


131S 


1316 


1317 


1318 1319 


2450 


1320 


1321 


1322 


1323 


1324 


1325 


1326 1327 


2460 


1328 


1329 


1330 


1331 


1332 


1333 


1334 1335 


2470 


1336 


1337 


1338 


1339 


1340 


1341 


1342 1343 


2500 


1344 


1345 


1346 


1347 


1348 


1349 


1350 1351 


2510 


1352 


1353 


1354 


1355 


1356 


1357 


1358 1359 


2520 


1360 


1361 


1362 


1363 


1364 


1365 


1366 1367 


2530 


1368 


1369 


1370 


1371 


1372 


1373 


1374 1375 


2540 


1376 


1377 


1378 


1379 


1380 


1381 


1382 1383 


2550 


1384 


1385 


1386 


1387 


1388 


1389 


1390 1391 


2560 


1392 


1393 


1394 


1395 


1396 


1397 


1398 1399 


2570 


1400 


1401 


1402 


1403 


1404 


1405 


1406 1407 


2600 


1408 


1409 


1410 


1411 


1412 


1413 


1414 1415 


2610 


1416 


1417 


1418 


1419 


1420 


1421 


1422 1423 


2620 


1424 


1425 


1426 


1427 


1428 


1429 


1430 1431 


2630 


1432 


1433 


1434 


1435 


1436 


1437 


1438 1439 


2640 


1440 


1441 


1442 


1443 


1444 


1445 


1446 1447 


2650 


1448 


1449 


1450 


1451 


1452 


1453 


1454 14SS 


2660 


1456 


1457 


1458 


1459 


1460 


1461 


1462 1463 


2670 


1464 


1465 


1466 


1467 


1468 


1469 


1470 1471 


2700 


1472 


1473 


1474 


1475 


1476 


1477 


1478 1479 


2710 


1480 


1481 


1482 


1483 


1484 


1485 


1486 1487 


2720 


1488 


1489 


1490 


1491 


1492 


1493 


1494 149S 


2730 


1496 


1497 


1498 


1499 


1500 


1501 


1502 1503 


2740 


1504 


1505 


1506 


1507 


1508 


1509 


1510 1511 


2750 


1512 


1513 


1514 


1515 


1516 


1517 


1518 1519 


2760 


1520 


1521 


1522 


1523 


1524 


1525 


1526 1527 


2770 


1528 


1529 


1530 


1531 


1532 


1533 


1534 1535 



2000 


1024 


to 


10 


2777 


1J3S 


(Ocfol) 


(Dtcimol) 


Octal 


Decimal 


10000 


4096 


20000- 


8192 


30000- 


12288 


40000- 


16384 


50000 


20430 


60000- 


24576 


70000- 


28672 



3000 
3010 
3020 
3030 
3040 
3050 
3060 
3070 

3100 
3110 
3120 
31 30 
3140 
3150 
3160 
317.0 

3200 
3210 
3220 
3230 
3240 
3250 
3260 
3270 

3300 
3310 
3320 
3330 
3340 
3350 
3360 
3370 



1 



6 



1536 1537 

1544 1545 

1552 1553 

1560 1561 

1568 1569 

1576 1577 

1584 1585 

1592 1593 

1600 1601 

1608 1609 

1616 1617 

1624 1625 

1632 1633 

1640 1641 

1648 1649 

1656 1657 



1538 
1546 
1554 
1562 
1570 
1578 
1586 
1594 

1602 
1610 
1618 
1526 
1634 
1642 
1650 
1658 



1539 
1547 
1555 
1563 
1571 
1579 
1587 
1595 



1540 1541 
1548 1549 
1556 1557 
1564 1565 
1572 1573 
1580 1581 
1588 1589 
1596 1597 



1603 1604 

1611 1612 
1619 1620 

1627 1628 

1635 1636 

1643 1644 

1651 1652 

1659 1660 



1605 
1613 
1621 
1629 
1637 
1645 
1653 
1661 



1542 1543 

1550 1551 

1558 1559 

1566 1567 

1574 1575 

1582 1583 

1590 1591 

1598 1599 

1606 1607 

1614 1615 

1622 1623 

1630 1631 

1638 1639 

1646 1647 

16j4 1655 

1662 1663 



1664 
1672 
1680 
1688 
1696 
1704 
1712 
1720 

1728 
1736 
1744 
1752 
1760 
1768 
1776 
1784 



1665 
1673 
1681 
1689 
1697 
1705 
1713 
1721 

1729 
1737 
1745 
1753 
1761 
1769 
1777 
1785 



1666 1667 
1674 1675 
1682 1683 
1690 1691 
1698 1699 
1706 1707 
1714 1715 
1722 1723 



1668 1669 
1676 1677 
1684 1685 
1692 1693 
1700 1701 
1708 1709 
I7I6 1717 
1724 1725 



1730 
1738 
1746 
1754 
1762 
1770 
1778 
1786 



1731 
1739 
1747 
1755 
1763 
1771 
1779 
1787 



1732 
1740 
1748 
1756 
1764 
1772 
1780 
1788 



1733 
1741 
1749 
1757 
1765 
1773 
1781 
1789 



1670 


1671 


1678 


1679 


1686 


1687 


1694 


1695 


1702 


1703 


1710 


1711 


1718 


1719 


1726 


1727 


1734 


1735 


1742 


1743 


1750 


1751 


1758 


1759 


1766 


1767 


1774 
1782 


1775 
1783 



1790 1791 



3400 
3410 
3420 
343C 
3440 
3450 
3460 
3470 

3500 
3510 
3520 
3530 
3540 
3550 
3560 
3570 

3600 
3610 
3620 
3630 
3640 
3650 
3660 
3670 

3700 
3710 
3720 
3730 
3740 
3750 
3760 
3770 



I 



6 



1792 
1800 
1808 
1816 
1824 
1832 
1840 
1848 

1856 
1864 
1872 
1880 
1888 
1896 
1904 
1912 

1920 
1928 
1936 
1944 
1952 
1960 
1968 
1976 



1793 
1801 
1809 
1817 
1825 
1833 
1841 
1849 

1857 
1865 
1873 
1881 
1889 
1897 
1905 
1913 



1794 1795 

1802 1803 

1810 iSli 

1818 1819 

1826 1827 

1834 1835 

1842 1843 

1850 1851 



1858 
1866 
1874 
1882 
1890 
1898 
1906 
1914 



1921 1922 

1929 1930 

1937 1938 

1945 1946 

1953 1954 

1961 1962 

1969 1970 

1977 1978 



1984 1985 

1992 1993 

2000 2001 

2008 2009 

2016 2017 

2024 2025 

2032 2033 

2040 2041 



1986 
1994 
2002 
2010 
2018 
2026 
2034 
2042 



1859 
1867 
1875 
1883 
1891 
1899 
1907 
1915 

1923 
1931 
1939 
1947 
19j5 
1963 
1971 
1979 

1987 
199S 
2003 
2011 
2019 
2027 
2035 
2043 



1796 
1804 
1812 
1820 
1828 
1836 
1844 
1852 

1860 
1868 
1876 
1884 
1892 
1900 
1908 
1916 

1924 
1932 
1940 
1948 
1956 
1964 
1972 
1980 

1988 
1996 
2004 
2012 
2020 
2028 
2036 
2044 



1797 1798 

1805 1806 

1813 ISI4 

1821 1822 

1829 1830 

1837 1838 

1845 1846 

1853 1854 



1799 
1807 
1815 
1823 
1831 
1839 
1847 
1855 



1861 
1869 
1877 
1885 
1893 
1901 
1909 
1917 

1925 
1933 
1941 
1949 
1957 
1965 
1973 
1981 

1989 
1997 
2005 
2013 
2021 
2029 
2037 
2045 



1862 I8S3 

1870 1871 

1878 1879 

1886 188? 

1894 1895 

1902 1903 

1910 1911 

1918 1919 

1926 1927 

1934 1935 

1942 1943 

1950 1951 

1958 1959 

1966 1967 

1974 1975 

1982 1983 

1990 1991 

1998 1999 

2006 2007 

2014 2015 

2022 2023 

2030 2031 

2038 2039 

2046 2047 



3000 1336 

to to 

3777 2047 

(Octal) (Occimoll 



F-4 



OCTAL- DECIMAL INTEGER CONVERSION TABLE (continued) 



4000 


:04S 


10 


lo 


4777 


2559 


(Ocioll 


(Drclmol 


Ocfal 


Decimal 


10000. 


4096 


20000- 


8192 


30000- 


12288 


40000- 


16384 


50000- 


20480 


60000- 


24576 


70000 - 


28672 








I 


2 


3 


4 


5 


6 


7 


4000 


2048 


2049 


2050 


2051 


2052 


2053 


2054 


2055 


4010 


2056 


2057 


2058 


2059 


2060 


2061 


2062 


2063 


4020 


2064 


2065 


2066 


2067 


2068 


2069 


2070 


2071 


4030 


2072 


2073 


2074 


2075 


2076 


2077 


2078 


2079 


4040 


2080 


2081 


2082 


2083 


2084 


2085 


2086 


2087 


4050 


2088 


2089 


2090 


2091 


2092 


2093 


2094 


2095 


4060 


2896 


2097 


2098 


2099 


2100 


2101 


2102 


2103 


4070 


2104 


2105 


2106 


2107 


2108 


2109 


2110 


2111 


4100 


2112 


2113 


2114 


2115 


2116 


2117 


2118 


2119 


4110 


2120 


2121 


2122 


2123 


2124 


2125 


2126 


2127 


4120 


2128 


2129 


2130 


2131 


2132 


2133 


2134 


2135 


4130 


2136 


2137 


2138 


2139 


2140 


2141 


2142 


2143 


4140 


2144 


2145 


2146 


2147 


2148 


2149 


2150 


2151 


4150 


2152 


2153 


2154 


2155 


2156 


2157 


2158 


2159 


4160 


2160 


2161 


2162 


2163 


2164 


2165 


2166 


2167 


4170 


2168 


2169 


2170 


2171 


2172 


2173 


2174 


2175 


4200 


2176 


2177 


2178 


2179 


2180 


2181 


2182 


2183 


4210 


2184 


2185 


2186 


2187 


2188 


2189 


2190 


2191 


4220 


2192 


2193 


2194 


2195 


2196 


2197 


2198 


2199 


4230 


2200 


2201 


2202 


2203 


2204 


2205 


2206 


2207 


4240 


2208 


2209 


2210 


2211 


2212 


2213 


2214 


2215 


42S0 


2216 


2217 


2218 


2219 


2220 


2221 


2222 


2223 


4280 


2224 


2225 


2226 


2227 


2228 


2229 


2230 


2231 


.4270 


2232 


2233 


2234 


2235 


2236 


2237 


2238 


2239 


4300 


2240 


2241 


2242 


2243 


2244 


2245 


2246 


2247 


4310 


2248 


2249 


2250 


2251 


2252 


2253 


2251 


2255 


4320 


2256 


2257 


2258 


2259 


2260 


2261 


2262 


2263 


4330 


2264 


2265 


2266 


2267 


2268 


2269 


2270 


2271 


4340 


2272 


2273 


2274 


2275 


2276 


2277 


2278 


2279 


4350 


2280 


2281 


2282 


2283 


2284 


2285 


2286 


2287 


4360 


2288 


2289 


2290 


2291 


2292 


2293 


2294 


2295 


4370 


2296 


2297 


2298 


2299 


2300 


2301 


2302 


2303 








1 


2 


3 


4 


5 


8 7 


4400 


2304 


2305 


2306 


2307 


2308 


2309 


2310 2311 


4410 


2312 


2313 


2314 


2315 


2316 


2317 


231S 2319 


4420 


2320 


2321 


2322 


2323 


2324 


2325 


2326 2327 


4430 


2328 


2329 


2330 


2331 


2332 


2333 


2334 233S 


4440 


2336 


2337 


2338 


2339 


2340 


2341 


2342 2343 


4450 


2344 


2345 


2346 


2347 


2348 


2349 


2350 2351 


4460 


2352 


2353 


2354 


235S 


2356 


2357 


2358 2359 


4470 


2360 


2361 


2362 


2363 


2364 


2365 


2366 2367 


4500 


2368 


2369 


2370 


2371 


2372 


2373 


2374 2375 


4510 


2376 


2377 


2378 


2379 


2380 


2381 


2382 2383 


4520 


2384 


2385 


2386 


2387 


2388 


2389 


2390 2391 


4^30 


2392 


2393 


2394 


2395 


2396 


2397 


2398 2399 


4540 


2400 


2401 


2402 


2403 


2404 


2405 


2406 2407 


4550 


2408 


2409 


2410 


2411 


2412 


2413 


2414 241S 


4560 


2416 


2417 


2418 


2419 


2420 


2421 


2422 2423 


4570 


2424 


2425 


2426 


2427 


2428 


2429 


2430 2431 


4600 


2432 


2433 


2434 


2435 


2436 


2437 


2438 2439 


4610 


2440 


2441 


2442 


2443 


2444 


2445 


2446 2447 


4620 


2448 


2449 


2450 


2451 


2452 


2453 


2454 2455 


4630 


2455 


2457 


2458 


2459 


2460 


2461 


2462 24^3 


4640 


2464 


2465 


2466 


2467 


2468 


2469 


2470 2471 


4650 


2472 


2473 


2474 


2475 


2476 


2477 


2478 2479 


4660 


2480 


248! 


2482 


2483 


2^84 


2485 


2486 2487 


4670 


2488 


2489 


2490 


2491 


2492 


2493 


2494 2495 


4700 


2495 


2497 


2498 


2499 


2500 


2501 


2502 2S03 


4710 


2504 


2505 


2506 


2507 


2508 


2509 


2510 2511 


4720 


2512 


2513 


2514 


2515 


2516 


2517 


2518 2519 


4730 


2520 


2521 


2522 


2523 


2524 


2525 


2526 252? 


4740 


2528 


2529 


2530 


2531 


2532 


2533 


2534 2535 


4750 


2536 


2537 


2538 


2539 


2540 


2541 


2542 2543 


4760 


2544 


2545 


2546 


2547 


2548 


2549 


2550 2551 


477012552 


2553 


2554 


2555 


2556 


2557 


2558 2559 



5000 


2560 


10 


lo 


5777 


3071 


Oclol) 


(Decimal) 








1 


2 


3 


4 


5 


6 


7 1 


5000 


2560 


2561 


2562 


2563 


2564 


2565 


2566 


2567 


5010 


2568 


2569 


2570 


2571 


2572 


2573 


2574 


2575 


5020 


2576 


2577 


2578 


2579 


2580 


2581 


25^2 


2583 


5030 


2584 


2585 


2586 


2587 


2588 


2589 


2590 


2591 


5040 


2592 


2593 


2594 


2595 


2596 


2597 


2598 


2599 


5050 


2600 


2601 


2602 


2603 


2604 


2605 


2606 


2607 


5060 


2608 


2609 


2610 


2611 


2612 


2613 


26H 


2615 


5070 


2616 


2617 


2618 


2619 


2620 


2621 


2622 


2623 


5100 


2624 


2625 


2626 


2627 


2628 


2629 


2630 


2631 


5110 


2632 


2633 


2634 


2635 


2636 


2637 


2638 


2639 


5120 


2640 


2641 


2642 


2643 


2644 


2645 


2646 


2647 


5130 


2648 


2649 


2650 


2651 


2652 


2653 


2654 


2655 


5140 


2656 


2657 


2658 


2659 


2660 


2661 


2662 


2663 


5150 


2664 


2665 


2666 


2667 


2668 


2669 


2670 


2671 


5160 


2672 


2673 


2674 


2675 


2676 


2677 


2678 


2679 


5170 


2680 


2681 


2682 


2683 


2684 


2685 


2686 


2687 


5200 


2688 


2689 


2690 


2691 


2692 


2693 


2694 


2695 


5210 


2696 


2697 


2698 


2699 


2700 


2701 


2702 


2703 


5220 


2704 


2705 


2706 


2707 


2708 


2709 


2710 


2711 


5230 


2712 


2713 


2714 


2715 


2716 


2717 


2718 


2719 


5240 


2720 


2721 


2722 


2723 


2724 


2725 


2726 


2727 


5250 


2728 


2729 


2730 


-2731 


2732 


2733 


2734 


2735 


5260 


2736 


2737 


2738 


2739 


2740 


2741 


2742 


2743 


5270 


2744 


2745 


2746 


2747 


2748 


2749 


2750 


2751 


5300 


2752 


2753 


2754 


2755 


2756 


2757 


2758 


2759 


S310 


2760 


2761 


2762 


2763 


2764 


2765 


2766 


2767 


5320 


2768 


2769 


2770 


2771 


2772 


2773 


2774 


2775 


5330 


2776 


2777 


2778 


2779 


2780 


2781 


2782 


2783 


5340 


2784 


2785 


2786 


2787 


2788 


2789 


2790 


2791 


5350 


2792 


2793 


2794 


2795 


2796 


2797 


2798 


2799 


5360 


2800 


2801 


2802 


2803 


2804 


2805 


2806 


2807 


5370 


2808 


2809 


2810 


2811 


2812 


2813 


2814 


2815 








1 


2 


3 


4 


5 


6 7 


5400 


2816 


2817 


2818 


2819 


2820 


2821 


2822 2823 


5410 


2824 


2825 


2826 


2827 


2828 


2829 


2830 2831 


5420 


2832 


2833 


2834 


2835 


2836 


2837 


2838 2838 


5430 


2840 


2841 


2842 


2843 


2844 


2845 


2846 2847 


5440 


2848 


2849 


2850 


2851 


2852 


2853 


2854 2aSS 


5450 


2856 


2857 


2858 


2859 


2860 


2861 


2862 286S 


5460 


2864 


2865 


2866 


2867 


2868 


2869 


2870- 2871 


5470 


2872 


2873 


2874 


2875 


2876 


2877 


2878 2879 


5500 


2880 


2881 


2882 


2883 


2884 


2885 


2886 2887 


5510 


2888 


2889 


2890 


2891 


2892 


2893 


2894 289S 


5520 


2896 


2897 


2898 


2899 


2900 


2901 


2902 2903 


5530 


2904 


2905 


-2906 


2907 


2908 


2909 


2910 2911 


5540 


2912 


2913 


2914 


2915 


2916 


2917 


2918 2919 


5550 


2920 


2921 


2922 


2923 


2924 


2925 


2926 2927 


5560 


2928 


2929 


2930 


2931 


2932 


2933 


2934 2935 


5570 


2936 


2937 


2938 


2939 


2940 


2941 


2942 2943 


5600 


2944 


2945 


2946 


2947 


2948 


2949 


2950 2951 


5610 


2952 


2953 


2954 


2955 


2956 


2957 


2958 29S9 


5620 


2960 


2961 


2962 


2963 


2964 


2965 


2966 2967 


5630 


2968 


2969 


2970 


2971 


2972 


2973 


2974 2975 


5640 


2976 


2977 


2978 


2979 


2980 


2981 


2982 2983 


5650 


2334 


2985 


2986 


2987 


2988 


2989 


2990 2991 


5660 


2992 


2993 


2994 


2995 


2996 


2997 


2998 2999 


5670 


3000 


3001 


3002 


3003 


3004 


3005 


3006 3007 


5700 


3008 


3009 


3010 


3011 


3012 


3013 


3014 3015 


5710 


3016 


3017 


3018 


3019 


3020 


3021 


3022 3023 


5720 


3024 


3025 


3026 


3027 


3028 


3029 


3030 3031 


5730 


3032 


3033 


3034 


3035 


3036 


3037 


3038 3039 


5740 


3040 


3041 


3042 


3043 


3044 


3045 


3046 3047 


5750 


3048 


3049 


3050 


3051 


3052 


3053 


3054 3055 


5760 


3056 


3057 


3058 


3059 


3060 


3061 


3062 3063 


5770 


3064 


3065 


3066 


3067 


3068 


3069 


3070 3071 



F-5 



OCTAL-DECIMAL INTEGER CONVERSION TABLE (continued) 



6000 

eoio 

eo2o 

6030 
6040 
6050 
6O60 



6070 3128 



6100 
6110 
6120 
6130 
6140 
6150 
6160 
6170 

6200 
6210 
6220 
6230 
6240 
6250 
6260 
6270 

6300 
6310 
6320 
6330 
6340 
6350 
6360 
6370 



3072 
3060 
3088 
3096 
3104 
3112 
3120 



3136 
3144 
3152 
3160 
3168 
3176 
3184 
3192 



3073 3074 

3081 3032 

3089 3090 

3097 3098 

3105 3106 

3113 3114 

3121 3122 

3129 3130 

3137 3138 

3145 3146 

3153 3154 

3161 3162 

3169 3170 

3177 3178 

3185 3186 

3193 3194 



3200 3201 

3208 3209 

3216 3tl7 

3224 3225 

3232 3233 

3240 3241 

3248 3249 

3256 3257 



3202 
3210 
3218 
3226 
3234 
3242 
3250 
3258 



3075 3076 

3063 3084 

3091 3092 

3099 3100 

3107 3108 

3115 3116 

3123 3124 

3131 3132 

3139 3140 

3147 3148 

3155 3156 

3163 3164 

3171 3172 

3179 3180 

3187 3188 

3195 3196 

3203 3204 

3211 3212 

3219 3220 

3227 3228 

3235 3236 

3243 3244 

3251 3252 

3259 3260 



3077 3078 

3085 3086 

3093 3094 

3101 3102 

3109 3110 

3117 3118 

3125 3126 

3133 3134 



3079 
3087 
3095 
3103 
3111 
3119 
3127 
3135 



3141 3142 bl43 

3149 3150 3151 

3157 3158 3159 

3165 3166 3167 

3173 3174 3175 

3181 3182 3183 

3189 3190 3191 

3197 3198 3199 



3264 
3272 
3280 
3288 
3296 
3304 
3312 
3320 



3265 3266 

3273 3274 

3281 3282 

3289 3290 

3297 3298 

3305 3306 

3313 3314 

3321 3322 



3267 
3275 
3283 
3291 
3299 
3307 
3315 
3323 



3268 
3276 
3284 
3292 
3300 
3308 
3316 
3324 



3205 
3213 
3221 
3229 
3237 
3245 
3253 
3261 

3269 
3277 
3285 
3293 
3301 
3309 
3317 
3325 



3206 3207 

3214 3215 

3222 3223 

3230 3231 

3238 3239 

3246 3247 

3254 3255 

3262 3263 

3270 3271 

3278 3279 

3286 3287 

3294 3295 

3302 3303 

3310 3311 

3318 3319 

3326 3327 



6400 
6410 
6420 
6430 
6440 
6450 
6460 
6470 

6500 
6510 
6520 
6530 
6540 
6550 
6560 
6570 

6600 
6610 
6620 
6630 
6640 
6650 
6660 
6670 

6700 
6710 
6720 
6730 
6740 
6750 
6760 
6770 



1 



3328 3329 

3336 3337 

3344 3345 

3352 3353 

3360 3361 

3368 3369 

3376 3377 

3384 3385 



3330 3331 

3338 3339 

3346 3347 

3354 3355 

3362 3363 

3370 3371 

3378 3379 

3386 3387 



3332 
3340 
3348 
3356 
3364 
3372 
3380 
3388 



3333 
3341 
3349 
3357 
3365 
3373 
3381 
3389 



3334 3335 

3342 3343 

3350 3351 

3358 3359 

3366 3367 

3374 3375 

3382 3383 

3390 3391 



3392 
3400 
3408 
3416 
3424 
3432 
3440 
3448 



3393 
3401 
3409 
3417 
3425 
3433 
3441 
3449 



3456 3457 

3464 3465 

3472 3473 

3480 3481 

3488 3489 

3496 3497 

3504 3505 

3512 3513 

3520 3521 

3528 3529 

3536 3537 

3544 3545 

3552 3553 

3560 3561 

3568 3569 

3576 3577 



3394 
3402 
3410 
3418 
3426 
3434 
3442 
3450 

3458 
3466 
3474 
3482 
3490 
3498 
3506 
3514 



3395 3396 

3403 3404 

3411 3412 

3419 3420 

3427 3428 

3435 3436 

3443 3444 

3451 3452 



3459 
3467 
3475 
3483 
3491 
3499 
3507 
3515 



3522 3523 

3530 3531 

3538 3539 

3546 3547 

3554 3555 

3562 3563 

3570 3571 

3578 3579 



3460 
3468 
3476 
3484 
3492 
3500 
3508 
3516 

3524 
3532 
3540 
3548 
3556 
3564 
3572 
3580 



3397 3398 

3405 3406 

3413 3414 

3421 3422 

3429 3430 

3437 3436 

3445 3446 

3453 3454 

3461 3462 

3469 3470 

3477 3478 

3485 3486 

3493 3494 

3501 3502 

3509 3510 

3517 3518 



3399 
3407 
3415 
3423 
3431 
3439 
3447 
345S 

3463 
3471 
3479 
3487 
3495 
3503 
3511 
3519 



3525 
3533 
3541 
3549 
3557 
3565 
3573 
3581 



3526 3527 

3534 3535 

3542 3543 

3550 3551 

3558 3559 

3566 3567 

3574 3575 

3582 3583 



6000 

la 

6777 

(Octal) 



Octol 

loooo 

20000 < 

30000- 

40000' 

50000 

60000- 

70000- 



3072 

la 
3S63 

(Decimal) 



Decimal 
4096 
8192 
12288 
16384 
20480 
24576 
28672 








1 


2 


3 


4 


5 


6 7 


7000 i 3584 


3585 


3586 


3587 


3588 


3589 


3590 3591 


7010 


3592 


3593 


3594 


3595 


3596 


3597 


3598 3599 


7020 


3600 


3601 


3602 


3603 


3604 


3605 


3606 3607 


7030 


3608 


3609 


3610 


3611 


3612 


3613 


3614 3615 


7040 


3616 


3617 


3618 


3619 


3620 


3621 


3622 3623 


7050 i 3624 


3625 


3626 


3627 


3628 


3629 


3630 3631 i 


7060| 3832 


3633 


3634 


3635 


3636 


3637 


3638 3639; 


7070 3640 


3641 


3642 


3643 


3644 


3645 


3646 36471 


7100 : 3648 


3649 


3650 


3651 


3652 


3653 


3654 3655; 


71101 3S56 


3657 


3658 


3659 


3660 


366! 


3662 3663 


7120 


3664 


3665 


3666 


3667 


3686 


3669 


3670 3671 


7130 


3872 


3673 


3674 


3675 


3676 


3677 


3678 3679 


7140 


3680 


3681 


3682 


3683 


3664 


3685 


3686 3687 


7150 


3688 


3689 


3690 


3691 


3692 


3693 


3694 3695 


7160| 3696 


3697 


3698 


3699 


3700 


3701 


3702 3703 


7170 


3704 


3705 


3706 


3707 


3708 


3709 


3710 3711 


7200 


3712 


3713 


3714 


3715 


3716 


3717 


S-Jie 3719 


7210 


3720 


3721 


3722 


3723 


3724 


3725 


3726 3727 


7220 


372B 


3429 


3730 


3731 


3732 


3733 


3734 3735 


7230 


3736 


3737 


3738 


3739 


3740 


3741 


3742 3743 


7240 


3744 


3745 


3746 


3747 


3748 


3749 


3750 3751 


7250 


3752 


3753 


3754 


3755 


3756 


3757 


3758 3759 


7260 


3760 


3761 


3762 


3763 


3764 


3765 


3766 3787 


7270 


3768 


3769 


3770 


3771 


3772 


3773 


3774 3775 


7300 


3776 


3777 


3778 


3779 


3780 


3781 


3782 3783 


7310 


3784 


3785 


3786 


3787 


3788 


3789 


3790 3791 


7320 


3792 


3793 


3794 


3795 


3796 


3797 


3798 3799 


7330 


3800 


3801 


3802 


3803 


3804 


3805 


3806 3807 


7340 


3101 


3809 


3810 


3811 


3812 


3813 


3814 3815 


7350 


3816 


3817 


3818 


3819 


3820 


3821 


3822 3823 


7360 


3124 


3825 


3826 


3827 


3628 


3829 


3830 3831 


7370 


3133 


3833 


3834 


3835 


3836 


3837 


3838 3839 



7400 
7410 
7420 
7430 
7440 
7450 



1 



3840 
3848 
3856 

3864 
3872 

3830 



7460 3866 
7470 3896 



7500 
7510 
7520 
7530 
7540 
7550 
7560 
7570 

7600 
7610 
7620 
7630 
7640 
7650 
7660 
7670 

7700 
7710 
7720 
7730 
7740 
7750 
7760 
7770 



3841 
3349 
3857 
3865 
3873 
3881 
33S9 
3897 



3904 3905 

3912 3913 

3920 3921 

3928 3929 

3936 3937 

3944 3945 

3952 3953 

3960 3961 



3842 
3850 
3858 
3866 
3874 
3882 
3690 
3898 

3906 
3914 
3922 
3930 
3938 
3946 
3954 
3962 



3843 

3851 
3859 
3867 
3875 
3383 
3691 
3899 

3907 
3915 
3923 
3931 
3939 
3947 
3955 
3963 



3844 
3852 
3860 
3868 
3876 
3384 
3392 
3900 



3845 3846 

3853 3854 

3861 3862 

3869 3870 

3877 3878 

3885 3886 

3893 3894 

3901 3902 



3847 
3855 
3863 
3871 
3879 
3887 
3895 
3903 



3908 3909 

3916 3917 

3924 3925 

3932 3933 

3940 3941 

3948 3949 

3956 3957 

3964 3965 



3968 
3976 
3984 
3992 
4000 
4008 
4016 
4024 

4032 
4040 
4048 
4056 
4064 
4072 
4080 
4088 



3969 
3977 
3985 
3993 
4001 
4009 
4017 
4025 



3970 3971 

3978 3979 

3986 3987 

3994 3995 

4002 4003 

4010 4011 

4018 4019 

4026 4027 



4033 4034 
4041 4042 
4049 4050 
4057 4058 
4065 4066 
4073 4074 
4081 4082 
4089 4090 



4035 
4043 
4051 
4059 
4067 
4075 
4083 
4091 



3972 
3980 
3988 
3996 
4004 
4012 
4020 
4028 

4036 
4044 
4052 
4060 
4068 
4076 
4084 
4092 



3973 
3981 
3989 
3997 
4005 
4013 
4021 
4029 

4037 
4045 
4053 
4061 
4069 
4077 
4085 
4093 







3910 


3911 


3918 


3919 


3926 


3927 


3934 


3935 


3942 


3943 


3950 


3951 


3958 


3959 


3966 


3967 


3974 


3975 


3982 


3983 


3990 


3991 


3998 


3999 


4006 


4007 


4014 


4015 


1022 


4023 


4030 


4031 


4038 


4039 


4046 


4047 


4054 


4055 


4062 


4063 


4070 


4071 


4078 


4079 


4086 


4087 


4094 


4095 



7000 

la 

7777 

(Octal) 



35S4 

to 

409S 

(Decimal) 



F-6 



OCTAL-DECIMAL FRACTION CONVERSION TABLE 









OCTAL 


DEC. 


OCTAL 


DEC. 


OCTAL 


DEC. 


OCTAL 


DKC. 


.000 


.000000 


.100 


. 125000 


.200 


. 250000 


.300 


.375000 


.001 


. 001953 


.101 


. 126953 


.^01 


.251953 


.301 


.37C953 


.002 


.(f03906 


.102 


. 128906 


.202 


. 25390G 


.302 


.378906 


.003 


.005859 


.103 


. 130859 


.203 


. 255859 


.303 


.380859 


.004 


.007812 


.104 


. 132812 


.204 


. 257812 


.304 


.382812 


.005 


. 009765 


.105 


. 134765 


.205 


.259765 


.305 


.384765 


.006 


.011718 


.106 


. 136718 


.206 


.261718 


.306 


.386718 


.007 


.013671 


.107 


. 138671 


.207 


. 263671 


.307 


.388671 


.010 


.015625 


.110 


. 140625 


.210 


. 265625 


.310 


.390625 


.011 


.017578 


.111 


. 142578 


.211 


.267578 


.311 


.392578 


.012 


.019531 


.112 


. 144531 


.212 


.269531 


.312 


.394531 


.013 


.021484 


.113 


. 146484 


.213 


. 271484 


.313 


.396484 


.014 


.023437 


.114 


. 148437 


.214 


. 273437 


.314 


.398437 


.015 


.025390 


.115 


. 150390 


.215 


.275390 


.315 


. 400390 


.016 


.027343 


.116 


. 152343 


.216 


.277343 


.316 


.402343 


.017 


.029296 


.117 


. 154296 


.217 


.279296 


.317 


.404296 


.020 


.031250 


.120 


. 156250 


.220 


. 281250 


.320 


.406250 


.021 


.033203 


.121 


. 158203 


.221 


.283203 


.321 


.408203 


.022 


.035156 


.122 


. 160156 


.222 


. 285156 


.322 


.410156 


.023 


.037109 


.123 


. 162109 


.223 


. 287109 


.323 


.412109 


.024 


.039062 


.124 


. 164062 


.224 


. 289062 


.324 


.414062 


.025 


.041015 


.125 


. 166015 


.225 


.291015 


.325 


.416015 


.026 


.042968 


.126 


. 167968 


.226 


.292963 


.326 


.417968 


.027 


.044921 


.127 


. 169921 


.227 


. 294921 


.327 


.419921 


.030 


.046875 


.130 


.171875 


.230 


. 296875 


.330 


.421875 


.031 


.048828 


.131 


.173828 


.231 


. 29882S 


.331 


. 423828 


.032 


.050781 


.132 


.175781 


.232 


.300781 


.332 


.426781 


.033 


. 052734 


.133 


. 177734 


.233 


. 302734 


.333 


.427734 


.034 


.054687 


.134 


. 179687 


.234 


.304687 


.334 


.429687 


.035 


.056640 


.135 


.181640 


.235 


.306640 


.335 


.431640 


.035 


.058593 


.136 


.183593 


.236 


.303593 


.336 


.433593 


.037 


. 060546 


.137 


. 185546 


.237 


.310546 


.337 


.435546 


.040 


.062500 


.140 


. 187500 


.240 


.312500 


.340 


.437500 


.041 


.064453 


.141 


. 189453 


.241 


.314453 


.341 


.439453 


.042 


.066406 


.142 


. 191406 


.242 


.316406 


.342 


.441406 


.043 


. 068359 


.143 


. 193359 


.243 


.318359 


.343 


.443359 


.044 


.070312 


.144 


. 195312 


.244 


.320312 


.344 


.445312 


.045 


.072265 


.145 


. 197265 


.245 


.322265 


.345 


.447265 


.046 


.074218 


.146 


.199218 


.246 


.324218 


.346 


.449218 


.047 


.076171 


.147 


.201171 


.247 


.326171 


.347 


.451171 


.050 


.078125 


.ISO 


.203125 


.250 


.328125 


.350 


.453125 


.051 


. 080078 


.151 


. 205078 


.251 


.330078 


.351 


.455078 


.052 


.082031 


.152 


. 207031 


.252 


. 332031 


.352 


.457031 


.053 


.083984 


.153 


.208984 


.253 


.333984 


.353 


.4589M 


.054 


.085937 


.154 


.210937 


.254 


. 335937 


.354 


.460937 


.055 


.087890 


.155 


.212890 


.255 


.337890 


.355 


.462890 


.056 


. 089843 


.156 


.214843 


.256 


.339843 


.356 


.464843 


.057 


.091796 


.157 


.216796 


.257 


.341796 


.357 


.466796 


.060 


. 093750 


.160 


.218750 


.260 


.343750 


.360 


.468750 


.061 


. 095703 


.161 


.220703 


.261 


.345703 


.361 


.470703 


.062 


. 097656 


.162 


. 222656 


.262 


.347656 


.362 


.472656 


.063 


. 099609 


.163 


. 224609 


.263 


.349609 


.363 


.474609 


.064 


.101562 


.164 


. 226562 


.264 


.351562 


.364 


.476562 


.065 


. 103515 


.165 


.228515 


.265 


.353515 


.365 


.478S1S 


.066 


. 105468 


.166 


. 230463 


.266 


.355468 


.366 


.460468 


.067 


.107421 


.167 


.232421 


.267 


.357421 


.367 


.482421 


.070 


. 109375 


.170 


. 234375 


.270 


.359375 


.370 


.484375 


.071 


.111328 


.171 


.236328 


.271 


.361328 


.371 


.486328 


.072 


.113281 


.172 


.238281 


.272 


.363281 


.372 


.4S82B1 


.073 


.115234 


.173 


.240234 


.273 


.365234 


.373 


.490234 


.074 


.117187 


.174 


.242187 


.274 


.367187 


.374 


.492187 


.075 


.119140 


.175 


.244140 


.275 


.369140 


.375 


.494140 


.076 


. 121093 


.176 


. 246093 


.276 


.371093 


.376 


.496093 


.077 


. 123046 


.177 


.248046 


.277 


.37304$ 


.377 


.498046 
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OCTAL-DECIMAL FRACTION CONVERSION TABLE (continued) 



OCTAL 



DEC. 



000000 


.000000 


OOOOOl 


.000003 


000002 


.000007 


000003 


.000011 


000004 


.000015 


000005 


.000019 


000006 


.000022 


OOOOOT 


.000026 


000010 


. 000030 


000011 


.000034 


.000012 


.000038 


.000013 


.000041 


.000014 


.000045 


.000015 


.000049 


.000016 


.000053 


.OOOOIT 


. 000057 


.000020 


. 000061 


,000021 


.000064 


.000022 


.000068 


.000023 


.000072 


. 000024 


.000076 


.000025 


.000080 


.000026 


. 000083 


.000027 


.000087 


.000030 


.000091 


.000031 


.000095 


.000032 


.000099 


.000033 


.000102 


.000034 


.000106 


.000035 


.000110 


.000036 


.000114 


.000037 


.000118 


.000040 


.000122 


.000041 


.000125 


.000042 


.000129 


.000043 


.000133 


. 000044 


.000137 


. 000045 


.000141 


.000046 


. 000144 


.000047 


.000148 


.000050 


.000152 


.000051 


.000156 


.000052 


.000160 


.000053 


. 000164 


.000054 


.000167 


.000055 


.000171 


.000056 


.000175 


.000057 


.000179 


.000060 


,000183 


.000061 


.000186 


.000062 


. 000190 


.000063 


.000194 


.000064 


.000198 


.000065 


.000202 


.000066 


. 000205 


.000067 


.000209 


.000070 


.000213 


.000071 


.000217 


.000072 


.000221 


.000073 


.000225 


.000074 


.000228 


.000075 


.000232 


.000076 


.000236 


.000077 


.000240 



CKTAL 



DEC. 



.000100 


,000244 


.000101 


,000247 


.000102 


.000251 


,000103 


.000255 


.000104 


.000259 


.000105 


.000263 


.000106 


.000267 


.OOOIOT 


,000270 


,000110 


.000274 


.000111 


.000278 


.000112 


.000282 


.000113 


.000286 


.000114 


.000289 


.000115 


,000293 


.000116 


,000297 


.000117 


,000301 


.000120 


,000305 


.000121 


,000308 


.000122 


,000312 


.000123 


,000316 


.000124 


.000320 


,000125 


.000324 


.000126 


.000328 


.000127 


.000331 


.000130 


.000335 


.000131 


,000339 


,000132 


.000343 


,000133 


,000347 


,000134 


,000350 


.000135 


,000354 


.000136 


,000358 


.000137 


.000362 


.000140 


.000366 


.000141 


.000370 


.000142 


.000373 


,000143 


.000377 


,000144 


.000381 


,000145 


.000385 


.000146 


.000389 


.000147 


.000392 


.000150 


.000396 


,000151 


.000400 


.000152 


.000404 


,000153 


.000408 


,000154 


.000411 


,000155 


,000415 


,000156 


,000419 


.000157 


,000423 


,000160 


,000427 


,000161 


,000431 


,000162 


,000434 


.000163 


,000438 


,000164 


,000442 


.000165 


,000446 


.000166 


.000450 


.000167 


,000453 


.000170 


.000457 


,000171 


.000461 


.000172 


.000465 


.000173 


.000469 


.000174 


.000473 


.000175 


.000476 


.000176 


.000480 


,000177 


.000484 



OCTAL 



DEC. 



000200 


.000488 


000201 


.000492 


.000202 


.000495 


.000203 


.000499 


.000204 


.000503 


.000205 


.000507 


.000206 


.000511 


.000207 


.COCSli 


.000210 


.000518 


.000211 


.000522 


.000212 


,000526 


.000213 


.000530 


.000214 


.000534 


.000215 


.000537 


.000216 


.000541 


.000217 


.000545 


.000220 


.000549 


,000221 


,000553 


.000222 


.000556 


.000223 


.000560 


.000224 


.000564 


.000225 


.000568 


.000226 


. 000572 


.000227 


,000576 


.000230 


,000579 


,000231 


,000583 


,000232 


.000587 


.000233 


.000591 


,000234 


.000595 


.000235 


,000598 


.000236 


,000602 


.000237 


,000606 


.000240 


.000610 


.000241 


.000614 


.000242 


.000617 


.000243 


.000621 


.000244 


.000625 


.000245 


.000629 


.000246 


.000633 


.000247 


.000637 


.000250 


.000640 


.000251 


.000644 


.000252 


.000648 


.000253 


. 000652 


.000254 


.000656 


.000255 


,000659 


.000256 


.000663 


.000257 


.000667 


.000260 


,000671 


.000261 


.000675 


.000262 


.000679 


.000263 


.000682 


.000264 


.000686 


.000265 


.000690 


.000266 


.000694 


. 000267 


.000698 


.000270 


.000701 


.000271 


.000705 


.000272 


.000709 


.000273 


.000713 


.000274 


.000717 


.000275 


.000720 


.000276 


.000724 


, 000277 


.000728 



OCTAL 



DEC. 



.000300 


.000732 


.000301 


.000736 


.000302 


.000740 


.000303 


.000743 


.000304 


.000747 


.000305 


.000751 


.000306 


.000755 


.000307 


.000759 


.000310 


.000762 


.000311 


.000766 


.000312 


.000770 


.000313 


.000774 


.000314 


.000778 


.000315 


.000782 


.000316 


.000785 


.000317 


.000789 


.000320 


.000793 


.000321 


.000797 


.000322 


.000801 


.000323 


.000805 


.000324 


.000808 


.000325 


.000812 


.000326 


.000816 


.000327 


.000820 


.000330 


.000823 


.000331 


.000827 


.000332 


.000831 


.000333 


.000835 


.000334 


.000839 


.000335 


.000843 


.000336 


.000846 


.000337 


.000850 


.000340 


.000854 


,000341 


.000858 


,000342 


.000862 


,000343 


.000865 


.000344 


.000869 


.000345 


.000873 


.000346 


.000877 


.000347 


.000881 


,000350 


.000885 


.000351 


.000888 


.000352 


.000892 


.000353 


.000896 


.000354 


,000900 


.000355 


,000904 


.000356 


.000907 


.0003CT 


.000911 


.000360 


.000915 


.000361 


.000919 


.000362 


.000923 


.000363 


,000926 


.000364 


.000930 


.000365 


.000934 


.000366 


.000938 


. 000367 


. 000942 


.000370 


.000946 


. 000371 


.000949 


.000372 


.000953 


,000373 


.000957 


,000374 


.000961 


.000375 


.000965 


.000376 


.000968 


.000377 


.000972 
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OCTAL-DECIMAL FRACTION CONVERSION TABLE (continued) 



OCTAL 


DEC. 


OCTAL 


DEC. 


OCTAL 


DEC. 


OCTAL 


DEC. 


.000400 


. 000976 


.000500 


.001220 


.000600 


.001464 


.000700 


.001708 


.000401 ■ 


. 000960 


.000501 


.001224 


.000601 


.001468 


.000701 


.001712 


. 000402 


. 000984 


.000502 


.001226 


.000602 


.001472 


.000702 


.001716 


. 000403 


. 000988 


.000503 


.001232 


.000603 


.001476 


.000703 


.001720 


.000404 


. 000991 


.000504 


.001235 


.000604 


.001480 


.000704 


.001724 


. 000405 


. 000995 


.000505 


.001239 


.000605 


.001483 


.000705 


.001728 


.000406 


. 000999 


.000506 


.001243 


.000606 


.001487 


.000706 


.001731 


.000407 


. 001003 


.000507 


.001247 


.000607 


.001491 


.000707 


.001735 


.000410 


. 001007 


.000510 


.001251 


.000610 


.001495 


.000710 


.001739 


.000411 


.001010 


.000511 


.001255 


.000611 


.001499 


.000711 


.001743 


.000412 


.001014 


.000512 


.001258 


.000612 


. 001502 


.000712 


.001747 


.000413 


.001018 


.000513 


.001262 


.000613 


. 001506 


. 000713 


.001750 


.000414 


.001022 


.000514 


.001266 


.000614 


.001510 


.000714 


.001754 


.000415 


.001026 


.000515 


.001270 


.000615 


.001514 


.000715 


.001758 


.000416 


.001029 


.000516 


.001274 


. 000616 


.001518 


.000716 


.001762 


.000417 


.001033 


.000517 


.001277 


.000617 


. 001522 


.000717 


.001766 


.000420 


.001037 


.000520 


.001281 


. 000620 


.001525 


.000720 


.001770 


.000421 


.001041 


.000521 


.001285 


. 000621 


.001529 


.000721 


.001773 


.000422 


.001045 


.000522 


.001289 


. 000622 


.001533 


.000722 


. 001777 


.000423 


.001049 


.000523 


.001293 


.000623 


.001537 


.000723 


.001781 


.000424 


.001052 


.000524 


.001296 


.000624 


.001541 


,000724 


.001785 


.000425 


.001056 


.000525 


. 001300 


.000625 


.001544 


.000725 


.001789 


.000426 


.001060 


.000526 


.001304 


.000626 


.001548 


.000726 


.001792 


.000427 


.001064 


.000527 


.001308 


.000627 


.001552 


.000727 


.001796 


.000420 


.001068 


.000530 


.001312 


.000630 


. 001556 


=000730 


=001800 


.000431 


.001071 


.000531 


.001316 


.000631 


.001560 


. 000731 


.001804 


.000432 


.001075 


.000532 


.001319 


.000632 


.001564 


.000732 


.001808 


.000433 


.001079 


.000533 


.001323 


.000633 


.001567 


.000733 


.001811 


.000434 


.001083 


.000534 


.001327 


.000634 


.001571 


.000734 


.001815 


.000435 


.001087 


.000535 


.001331 


. 000635 


.001575 


.000735 


.001819 


.000436 


.001091 


.000536 


.001335 


.000636 


.001579 


.000736 


.001823 


.000437 


.001094 


.000537 


.001338 


.000637 


.001583 


. 000737 


.001827 


.000440 


.001098 


.000540 


.001342 


.000640 


. 001586 


. 000740 


.001831 


.000441 


.001102 


.000541 


.001346 


.000641 


.001590 


. 000741 


.001834 


.000442 


.001106 


.000542 


.001350 


.000642 


.001594 


. 000742 


.001838 


.000443 


.001110 


.000543 


.001354 


. 000643 


. 001598 


.000743 


.001842 


.000444 


.001113 


.000544 


.001358 


.000644 


.001602 


.000744 


.001846 


.000446 


.001117 


.000545 


.001361 


.000645 


.001605 


.000745 


.001850 


.000446 


.001121 


.000546 


.001365 


.000646 


. 001609 


.000746 


.001853 


.000447 


.001125 


.000547 


.001369 


.000647 


.001613 


,000747 


. 001857 


.000450 


.001129 


.000550 


.001373 


.000650 


.001617 


.000750 


.001861 


.0004S1 


.001132 


.000551 


.001377 


.000651 


.001621 


.000751 


.001865 


.000452 


.001136 


.000552 


.001380 


.000652 


.001625 


.000752 


.001869 


.000453 


.001140 


.000553 


.001384 


.000653 


.001628 


.000753 


.001873 


.000454 


.001144 


.000554 


.001388 


.000654 


.001632 


.000754 


.001876 


.000455 


.001148 


.000555 


.001392 


.000655 


.001636 


.000755 


.001880 


.000456 


.001152 


.000556 


.001396 


.000656 


.001640 


.000756 


.001884 


.000457 


.001155 


.000557 


.001399 


.000657 


.001644 


.000757 


,001888 


.000460 


.001159 


.000560 


.001403 


.000660 


.001647 


.000760 


,001892 


.000461 


.001163 


.000561 


.001407 


.000661 


.001651 


.000761 


,001895 


.000462 


.001167 


.000562 


.001411 


.000662 


.001655 


.000762 


,001899 


.000463 


.001171 


.000563 


.001415 


.000663 


. 001659 


.000763 


,001903 


.000464 


.001174 


.000564 


.001419 


000664 


.001663 


.000764 


.001907 


.000465 


.001178 


.000565 


.001422 


.000665 


. 001667 


.000705 


.001911 


.000466 


.001182 


.000566 


.001426 


.000666 


.001670 


.000766 


.001914 


.000467 


. 001186 


.000567 


. 001430 


000667 


.001674 


.000767 


,001918 


.000470 


.001190 


.000570 


.001434 


. 000670 


. 001678 


.000770 


,001922 


.000471 


.001194 


.000571 


.001438 


.000671 


.001682 


,000771 


,001926 


.000472 


.001197 


.000572 


.001441 


.000672 


.001686 


,000772 


,001930 


.000473 


.001201 


.000573 


.001445 


.000673 


.001689 


.000773 


,001934 


.000474 


.S012Q& 


.000574 


.001449 


.000674 


.001693 


,000774 


.001937 


.000475 


.001209 


.000575 


.001453 


.000675 


.001697 


.000775 


,001941 


.000476 


.001213 


.000576 


.001457 


.000676 


.001101 


.000776 


,001945 


.000477 


.001216 


.000577 


.001461 


.000677 


.001705 


,000777 


,001949 
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GLOSSARY 



AFT (ATTACH FLAG TABLE) 

A table corresponding to the Logical Unit Table (LUT) with 2 word 
entries for each LUT slot. Whenever a Logical Unit Number (LUN) 
is attached to a Task, the Task name is set in the corresponding 
AFT slot. Whenever a LUN and Device-unit are both attached to a 
Task, the Device attach flag in the Physical Device List points 
to the appropriate AFT slot. 

ATL (ACTIVE TASK LIST) 

A priority ordered list of Active Tasks used to drive the system. 
The ATL is a deque consisting of one node for each Active Task 
in the system. 

CAL INSTRUCTION 

r\ jri^jT J.J xlciJ- *^w Clio -LuSuXuCi — Lwii uoova \^G j.oi^uoou iL^cCuulvc rOuuiliCCs. 

All System Directives issue CAL instructions to the Executive 
when making their requests. 

CAL PARAMETER BLOCK 

A block consisting of one or more words of contiguous core used 
to store parameters when issuing System Directives. The System 
Directive is implemented as a CAL Instruction with the address of 
the CAL Parameter Block as its operand. 

CLOCK QUEUE 

The Clock Queue is a deque consisting of one node for each item 
to be done at some time in the future. These items are: schedu- 
ling of Tasks (SCHEDULE, RUN, and SYNC Directives), rescheduling 
of Tasks (Clock interrupt service routine) , and setting of Event 
Variables after elapsed time periods (MARK Directive) . The nodes 
are linked in the order in which they come due. 

COMMON BLOCK, INTERNAL 

An area of contiguous core memory within a partition, available 
only. to the Task in the partition during its residency- 

COMMON BLOCK, SYSTEM 

An area of contiguous core memory, defined at System Configuration 
time, where data can be stored and referenced by all Tasks. A 
SYSTEM COMMON BLOCK is referenced by using a COMMON name matching 
a SYSTEM COMMON BLOCK name and declaring that COMMON as SYSTEM 
COMMON to the Task Builder. 

CONSOLE TELETYPE 

The control Teletype of the RSX System where MCR Function requests 
may be issued by the operator. 

CONTROL TABLE 

A 3-word table used when requesting or relinquishing disk space 
or when issuing disk GET and PUT Directives. 



CORE RESIDENT TASK 

A Task which has been fixed-in-core. 

DEFAULT PRIORITY 

A priority given to a Task during Task Building or Task Installation 
that is used when a priority is not specified and the Task's ex- 
ecution is requested or scheduled. 

DEQUE 

A double ended queue consisting of a listhead and list elements 
(nodes) , circularly linked by both forward and backward pointers. 
Deques, or link lists, are used, rather than tables, to store 
system information. 

DIRECTIVES 

Instructions to the RSX Executive (implemented with the use of 
CAL Instructions) , to perform indicated operations. 

DISK RESIDENT TASK 

A Task which normally resides on the disk and is brought into a 
core partition when requested. 

EVENT VARIABLE 

A word or variable used to determine the status of a Directive. 
The Event Variable is set to indicate successful completion, 
rejection, status, or a request still pending. An Event Variable 
address of zero indicates that no Event Variable is specified. 

EXECUTIVE 

The heart of the real-time operating system. It coordinates all 
activities in the system including Task scheduling, I/O super- 
vision, resource allocation, and interactive operator communication. 

I/O HANDLER TASK 

A Task in the RSX System which contains an interrupt service routine. 
I/O Handler Tasks are requested whenever they are assigned to a 
LUN. 

LISTHEAD 

A two-word core block with forward and backward pointers pointing 
to the next and previous list node or to itself if empty. The 
listhead is a reference point in a circularly linked list. 

LINKED LIST 

A deque consisting of nodes and listhead used to store system 
information. An empty list consists of only a listhead. 

LUN (LOGICAL UNIT NUMBER) 

Logical Unit Numbers are used to represent Logical I/O Device Units 



rather than Physical Units. Each Logical Unit Nxutiber is repre^ 
sented by an entry in the Logical Unit Table. 

LUT (LOGICAL UNIT TABLE) 

A block of contiguous core with a one-word entry, or slot, for 
each Logical Unit Number. When a LUN is assigned to a Physical 
Device Unit, the corresponding LUT slot contains the address of 
the appropriate Physical Device List node. 

MCR( MONITOR CONSOLE ROUTINE) 

The MCR allows the user to communicate on-line with the system 
from the console teleprinter. The MCR consists of the Resident 
MCR Task, which accepts user's commands, and the MCR Functions, 
which actually carry out the indicated requests. 

NODES 

The list elements of a deque. All nodes (of dynamic lists) 
consist of the listhead followed by eight words of data (list 
elements) . 

PARTITION 

An area of contiguous core memory, defined at System Configuration 
time, from which Tasks are executed. 

PARTITION BLOCK 

An abnormal node (34 g words) generated by the System Configurator 
to serve three functions. (1) It contains partition description 
information to assure that a Task being installed into the system 
has been built for an existing partition; (2) It provides core 
for an Event Variable and disk (DSKGET) control table necessary 
to load Tasks into partitions; and (3) it provides for saving 
a Task's environment when it is interrupted by the Executive. 

PBDL (PARTITION BLOCKS DESCRIPTION LIST) 

Partition Blocks generated by the System Configurator are linked 
together into a deque called the PBDL. 

PDVL (PHYSICAL DEVICE LIST) 

A deque constructed by the System Configurator used to describe 
the devices and units in the system. When a logical I/O unit 
is assigned to a physical unit, the address of the node describing 
the device and unit is set in a LUT entry corresponding to the LUN. 

POOL (POOL OF EMPTY NODES) 

Empty ten-word nodes for use in any deque. The Pool is generated 
by the System Configurator from core area that has not been 
specified for other use. 

SCDL (SYSTEM COMMON BLOCK DEFINITIONS LIST) 

A deque consisting of nodes which contain a record of the descrip- 
tions of each System COMMON Block. 



SIGNIFICANT EVENT 

An event which results in the scanning of the Active Task List. 
The following events are considered "Significant Events": (1) 
I/O queuing; (2) normal I/O request completion (dependent upon 
I/O Handler Task); (3) A Task request; (4) a scheduled SCHEDULE, 
RUN, or SYNC coming due; (5) a Mark time expiration; (6) a 
Task resumption (RESUME Directive) ; and (7) a Task EXIT. 

STL (SYSTEM TASK LIST) 

A directory of all Tasks in the System. 

SYSTEM CONFIGURATOR 

A Task which allows the user to tailor the RSX System to best 
fit his requirements. 

TKB 

The Task Builder program used to build executable Tasks from 
relocatable binary files. 

TRIGGER EVENT VARIABLE 

An Event Variable referenced within a PDVL node. The Trigger 
Event Variable is used to stimulate a dormant I/O Handler Task. 



HOW TO OBTAIN SOFTWARE INFOR.MATION 

Announcements for new and revised software, as well as programming notes, 
software problems, and documentation corrections are published by Software 
Information Service in the following newsletters. 

Digital Software News for the PDP-8 & PDP-12 

Digital Software News for the PDP-11 

Digital Software News for the PDP-9/15 Family 

These newsletters contain information applicable to software available from 
Digital's Program Library, Articles in Digital Software News update the 
cumulative Software Performance Summary which is contained in each basic 
kit of system software for new computers. To assure that the monthly Digital 
Software News is sent to the appropriate software contact at your installation, 
please check with the Software Specialist or Sales Engineer at your nearest 
Digital office. 

Questions or problems concerning Digital's Software should be reported to 
the' Software Specialist. In cases where no Software Specialist Is available, 
please send a Software Performance Report form with details of the problem to: 

Software Information Service 
Digital Equipment Corporation 
146 Main Street, Bidg. 3-5 
Maynard, Massachusetts 01754 

These forms which are provided in the software kit should be fully filled out 
and accompanied by teletype output as well as listings or tapes of the user 
program to facilitate a complete investigation. An answer will be sent to the 
individual and appropriate topics of general interest will be printed in the 
newsletter. 

Orders for new and revised software and manuals, additional Software Per- 
formance Report forms, and software price lists should be directed to the 
nearest Digital Field office or representative, U.S.A. customers may order 
directly from the Pro^^rnm Library in Maynard. When ordering, include the 
code number and a brief description of the software requested. 

Digital Equipment Computer Users Society (DECUS) maintains a user library 
and publishes a catalog of programs as well as the DECUSCOPE magazine 
for its members and non-members who request it. For further information 
please write to: 

DECUS 

Digital Equipment Corporation 
146 Main Street, Bidg. 3-5 
Maynard, Massachusetts 01754 
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READER'S COMMENTS 



Digital Equipment Corporation maintains a continuous effort to improve the quality and usefulness 
of its publications. To do this effectively we need user feedback — your critical evaluation of 
this manual. 

Please comment on this manual's completeness, accuracy, organization, usability and read- 
ability. 



Did you find errors in this manual? If so, specify by page. 



Other comments? 



Please state your position. 

Name: 

Street: 



How can this manual be improved? 



Date: 



Organization: 
Department: 



State: 



Zip or Country 
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